Communityコーディング&開発github.com

jintomjose/mini-software-factory

漠然としたアイデア、ユーザーの苦情、インシデントを、問題を抱える本人へのインタビューを通じてコミット可能な intent.md に変換します。仕様やコードを作成する前に、「〜したい」「ユーザーが〜し続けている」「〜すべき」「〜を追加できる?」と言われたときに使用します。

mini-software-factory とは?

このスキルは、開発プロセスの初期段階で、漠然とした要求や問題の記述(「〜したい」「ユーザーが〜で困っている」「〜を追加できる?」など)を、具体的で検証可能な意図文書(intent.md)に変換することを支援します。アナリストの役割に徹し、解決策の提案は行わず、問題の当事者へのインタビューを通じて、「誰が」「何が起こっているか」「どうなれば解決か」「変えてはいけない制約は何か」「なぜ今なのか」「最小限の検証可能なバージョンは何か」の6つの質問を順に1つずつ尋ねます。曖昧な回答には具体例を求め、場合によってはアイデア自体を却下する判断も支援します。出力は `work/<short-slug>/intent.md` として保存され、このファイルのコミットが次の `/write-spec` スキルへのトリガーとなります。Claude Code, Cursor, Codex などの AI エージェントで利用可能であり、仕様やコード作成の前に意図を明確にすることで、無駄な実装を防ぎ、関係者の合意形成を促進します。

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

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

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

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

ドキュメント

意図の捕捉

あなたはアナリストであり、ビルダーではありません。まだ解決策を提案してはいけません。あなたの出力は work/<short-slug>/intent.md という1つのファイルで、factory/templates/intent.md から値を埋めて作成します。

まずインタビュー

一度に1つの質問をし、回答を待ちます。推測せずに全てのセクションを埋められるまで続けます。以下の内容をカバーします:

  1. 誰がこの問題を抱えているのか?「ユーザー」ではなく、実在の人物またはセグメントを指定してください。
  2. 今日、何が起こっているのか、ステップバイステップで、それが彼らにどのようなコスト(時間、お金、リスク、フラストレーション)をもたらしているのか?
  3. 解決したとどうやってわかるのか? 1つの観測可能な結果。理想的には数値で表します。
  4. 変えてはいけないものは何か? 制約:データ、プライバシー、法律、お金、その他の機能。
  5. なぜ今なのか? 3ヶ月間何もしなかった場合、何が起こるのか?
  6. 結果を検証できる最小のバージョンは何か?

回答が曖昧な場合(「良くする」「より魅力的にする」など)は、具体例を求めます。相手がアイデア自体を否定し始めたら、それは良い結果です。そのことを伝えて停止します。

次に執筆

  • 問題については、本人の言葉をそのまま使います。引用符で囲んでください。
  • 未解決の事項はすべて 未解決の質問 のセクションに記載します。自分で解決しないでください。
  • ドラフトを提示し、修正を受け入れ、その後にファイルを保存します。
  • intent.md をコミットすることが /write-spec のトリガーであることを相手に伝えてください。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

関連スキル