Our review
Provides a structured template and guide for creating a functional design document (機能設計書), saved to docs/functional-design.md, based on existing product requirements.
Strengths
- Clear prerequisite check for product requirements.
- Provides a template and detailed guide for writing.
- Establishes priority of existing functional design docs over the generic guide.
- Defines a specific output path.
Limitations
- Only addresses functional design documentation, not broader architecture.
- Requires an existing product requirements document.
- Assumes a project structure with a docs/ directory.
Use when a feature or module needs a functional design specification derived from an existing PRD.
Do not use when no PRD exists, or when writing other documentation like API specs or test plans.
Security analysis
SafeThe skill only declares Read and Write tools and provides instructions for creating functional design documents. It does not execute commands, access network, or manipulate files beyond writing documentation. No destructive, exfiltrating, or obfuscated actions are present.
No concerns found
Examples
Write a functional design document for the user login feature using docs/product-requirements.md. Save it to docs/functional-design.md.Update docs/functional-design.md to reflect the latest changes in the product requirements, maintaining the existing structure.Please create a functional design document for the new payment module based on the PRD at docs/product-requirements.md.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
API Documentation Generator
Documentation
Automatically generates OpenAPI/Swagger API documentation.
Technical Writer
Documentation
Writes clear technical documentation following top style guides.
Project Documentation Lookup
Documentation
Quickly find project information in the docs/ folder: state, runbooks, strategies, and references.