Communitygithub.com

jintomjose/mini-software-factory

committed intent.mdをspec.md(要件と設計を1つの成果物にまとめたもの)に変換し、ポリシー上の懸念事項や未解決の決定事項をインラインでフラグ付けします。capture-intentの後、planモードの前に使用します。

mini-software-factory とは?

このスキルは、開発者がすでに作成した `intent.md`(実装意図の記述)から、構造化された `spec.md`(要件定義書兼設計書)を自動的に生成するためのものです。AIエージェント(特にClaude Codeのようなコード生成エージェント)を前提として設計されており、`factory/templates/spec.md` をテンプレートとして使用します。このスキルの最大の特徴は、コードベースを実際に読み込むことで「制約を見逃さない」点にあります。specを書く前に、変更が及ぶ部分のコードを読むことで、実際のアーキテクチャや既存のパターンに沿った現実的な仕様を作成できます。また、ユーザーストーリーを優先順位(P1, P2, P3)で整理し、各機能要件(FR-001)や成功基準(SC-001)に安定したIDを付与することで、レビューやテストで参照しやすくなります。さらに、決定が保留されている事項には `[NEEDS CLARIFICATION: ...]`、プライバシーやセキュリティなどのポリシーが適用される箇所には `[POLICY: ...]` というフラグをインラインで挿入するため、人間の開発者との協業がスムーズになります。最後に、すべての未解決事項を人間と解決した上で `spec.md` を保存し、これをトリガーに次のplanモードへ移行します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jintomjose/mini-software-factory/tree/HEAD/.claude/skills/write-spec

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

仕様書作成

入力: work/<feature>/intent.md。出力: work/<feature>/spec.md(factory/templates/spec.md より)。

  1. intent.md、CLAUDE.md、および変更が及ぶコードベースの該当部分を読み込む。コードを読まずに仕様を書くと制約を見落とす。これが最も一般的な失敗である。
  2. ユーザーストーリーを優先順位(P1、P2、P3)で記述する。各P1ストーリーは、単独で出荷可能かつテスト可能でなければならない。
  3. すべての機能要件に安定したID(FR-001)を、すべての成功基準にも同様にID(SC-001)を付与する。レビューおよびテストではこれらのIDを参照する。
  4. 以下の事項については、黙って解決せず、必ずインラインでフラグ付けする:
    • [NEEDS CLARIFICATION: ...]: 意図が決定を下していないあらゆる決定事項
    • [POLICY: privacy | security | legal | money | brand]: ルールが適用される箇所すべてに、そのルールを付記
  5. 設計セクションは、計画に必要な範囲でのみ記述する: データ変更、インターフェース、状態、エラーケース。
  6. 明示的に対象外とする項目を列挙する。
  7. 仕様を提示し、すべての [NEEDS CLARIFICATION] を人間と解決してから保存する。spec.md をコミットすることが、planモードへのトリガーとなる。

関連スキル