Notre avis
Ce guide fournit un modèle et des instructions pour créer ou mettre à jour des documents de conception fonctionnelle (機能設計書) à partir d'un document de spécification produit (PRD).
Points forts
- Fournit un modèle structuré pour une documentation cohérente
- Intègre une hiérarchie claire entre le PRD et la conception fonctionnelle
- Guide la mise à jour en préservant les documents existants
Limites
- Dépend de l'existence préalable d'un PRD
- Le modèle générique peut nécessiter des ajustements spécifiques au projet
- Ne couvre pas les aspects d'architecture technique détaillée
Utilisez cette compétence lorsque vous devez créer un nouveau document de conception fonctionnelle ou mettre à jour un existant, en partant d'un PRD validé.
Évitez de l'utiliser si aucun PRD n'est disponible, ou si la conception est purement technique sans besoin de documentation formelle.
Analyse de sécurité
SûrThe skill only uses Read and Write tools to create a documentation file; there are no execution of commands, network access, or any potentially harmful operations.
Aucun point d'attention détecté
Exemples
Create a functional design document for the user authentication feature based on the PRD at docs/product-requirements.md, following the template in template.md.Update the functional design document in docs/functional-design.md to reflect the new requirements for the payment module as described in the latest PRD.name: functional-design description: 機能設計書を作成するための詳細ガイドとテンプレート。機能設計書作成時にのみ使用。 allowed-tools: Read, Write
機能設計書作成スキル
このスキルは、高品質な機能設計書を作成するための詳細ガイドです。
前提条件
機能設計書作成を開始する前に、以下を確認してください:
docs/product-requirements.md が作成されている
必須: PRDが以下の場所に存在する必要があります:
ファイルパス: docs/product-requirements.md
機能設計書は、PRDで定義された要件を技術的に実現する方法を詳細化します。
既存ドキュメントの優先順位
重要: docs/functional-design.md に既存の機能設計書がある場合、
以下の優先順位に従ってください:
-
既存の機能設計書 (
docs/functional-design.md) - 最優先- プロジェクト固有の設計が記載されている
- このスキルのガイドより優先する
-
このスキルのガイド - 参考資料
- 汎用的なテンプレートと例
- 既存設計書がない場合、または補足として使用
新規作成時: このスキルのテンプレートとガイドを参照 更新時: 既存設計書の構造と内容を維持しながら更新
出力先
作成した機能設計書は以下に保存してください:
docs/functional-design.md
テンプレートの参照
機能設計書を作成する際は、次のテンプレートを使用してください: ./template.md
詳細ガイド
さらに詳しい作成ガイドは次のファイルを参照してください: ./guide.md
Generateur de Documentation API
Documentation
Genere automatiquement de la documentation API OpenAPI/Swagger.
Rédacteur Technique
Documentation
Rédige de la documentation technique claire selon les meilleurs style guides.
Créer des entrées de journal avec timestamps
Documentation
Crée des entrées de journal horodatées pour documenter les découvertes, réunions, revues de code, articles ou événements significatifs. Structure les informations avec un résumé, un type d'événement, des sources et des tags, puis enregistre le fichier dans `docs/log/` avec un nom basé sur la date et un slug descriptif.