Communityライティング&編集github.com

AaronCx/claude-code-practices

大規模な機能を構築する前に、ユーザーに詳細なインタビューを行い、自己完結型のSPEC.mdを作成します。新しいセッションでその仕様書を元に実装します。

claude-code-practices とは?

このスキルは、Claude CodeなどのAIエージェント上で大規模な機能を実装する前に、設計上の考慮漏れを防ぐために使用します。ユーザーに対して「AskUserQuestion」ツールを使い、技術実装、UI/UX、エッジケース、懸念点、トレードオフなど、詳細なインタビューを段階的に行います。表面的な質問ではなく、ユーザーがまだ気づいていない難しい部分を掘り下げ、すべての側面がカバーされるまで質問を続けます。その後、インタビュー結果をもとに自己完結型のSPEC.mdを作成します。この仕様書は、関連するファイル名やインターフェースを明記し、スコープ外とする事項を明示し、最後に機能が正しく動作することを確認するエンドツーエンドの検証手順を含むことが最も重要です。最後に、ユーザーに `/clear` を実行して新しいセッションでSPEC.mdから実装を始めるよう指示することで、実装コンテキストが仕様書のみに集中し、設計上の認識違いや実装漏れを減らすことができます。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AaronCx/claude-code-practices/tree/HEAD/skills/spec-interview

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

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

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

ドキュメント

ユーザーが構築したいもの: $ARGUMENTS

AskUserQuestion ツールを使って、詳細にインタビューを行ってください。技術実装、UI/UX、エッジケース、懸念点、トレードオフについて質問します。自明な質問は避け、ユーザーがまだ考慮していないかもしれない難しい部分を掘り下げてください。すべての側面がカバーされるまでインタビューを続けます。

その後、完全な仕様書を SPEC.md に記述します。最も有用な仕様書は自己完結型です。関係するファイル名やインターフェースを明記し、スコープ外とする事項を明示し、最後に機能が正しく動作することを確認するエンドツーエンドの検証手順を記述してください。

最後に、ユーザーに /clear を実行し、新しいセッションで SPEC.md から実装を始めるよう伝えてください。そうすることで、実装コンテキストは仕様書のみに集中します。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

関連スキル