Run any Skill in Manus with one click

spec-based-development

Stars5

Forks0

UpdatedFebruary 26, 2026 at 19:43

Generate detailed, agent-executable feature specifications by interviewing the user with AskUserQuestionTool. Transforms rough ideas into comprehensive SPEC.md files through phased deep interviews (5 phases) covering technical architecture, data design, API design, UI/UX, edge cases, security, performance, and tradeoffs. Produces hybrid specs with Acceptance Criteria and phased implementation tasks with dependencies. Use when user mentions "spec", "仕様書作成", "仕様駆動", "インタビューして", "SPEC.md", "feature spec", "仕様を書いて", "大きな機能を計画", or wants to plan a feature before implementation.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

kaijutale

kaijutale/claude-code

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

File Explorer

3 files

SKILL.md

readonly

name

spec-based-development

description

Spec-Based Development

AskUserQuestionToolでフェーズ制インタビューを実施し、Agentが自律実装可能な精度のSPEC.mdを生成する。

Workflow

Task Progress:

Step 1: アイデア把握
Step 2: 既存SPEC.md確認
Step 3: フェーズ制インタビュー実施
Step 4: SPEC.md書き出し
Step 5: 次ステップ案内

Step 1: アイデア把握

ユーザーの入力から対象機能・プロジェクトの概要を把握する。情報が不足していても問題ない（Step 3で掘り下げる）。

Step 2: 既存SPEC.md確認

プロジェクトルートに SPEC.md が存在するか確認する。

存在する場合: 内容を読み込み、既存の仕様を踏まえてインタビューする
存在しない場合: 新規作成前提で進む

Step 3: フェーズ制インタビュー実施

5フェーズで段階的に深堀りする。各フェーズの開始時に現在のフェーズ名をユーザーに伝えること。

フェーズ概要:

概要・ゴール（3-5問）: 目的、ターゲットユーザー、成功指標、スコープ境界
技術的実装（10-15問）: アーキテクチャ、データ設計、API設計、状態管理、外部依存
UI/UX（5-10問）: 操作フロー、状態遷移、レスポンシブ、アクセシビリティ ※該当時のみ
エッジケース・非機能要件（5-10問）: 異常系、セキュリティ、パフォーマンス、運用
トレードオフ・未決定事項（3-5問）: 技術選定理由、MVP境界、既知のリスク

各フェーズの詳細な質問パターンは references/interview-phases.md を参照。

CRITICAL: インタビュールール:

明らかな質問はしない。ユーザーが考慮していなかった深い部分を掘り下げる
1回のAskUserQuestionToolで1-4問ずつ質問する
大きな機能では最低40問以上質問すること
ユーザーが「完了」「十分」「もういい」と言うまで継続する
技術フェーズでは特に深く掘り下げる（DB選定で終わらず、インデックス戦略・キャッシュ無効化・トランザクション境界まで）

Step 4: SPEC.md書き出し

インタビュー結果をプロジェクトルートの SPEC.md に書き出す。

フォーマットは references/spec-template.md を参照。ハイブリッド型テンプレートを使用し、以下を必ず含める:

機能要件: 各要件にAcceptance Criteria（チェックボックス形式）
実装タスク: フェーズ分割・依存関係・完了条件付き

セクションは機能の性質に応じて調整する。不要なセクションは省略してよい。

Step 5: 次ステップ案内

SPEC.md作成後、以下を案内する:

SPEC.mdを作成しました！

次のステップ:
1. SPEC.mdの内容を確認・修正してください
2. 実装は新しいセッションで行うのがおすすめです:
   - /clear でコンテキストをリセット
   - 「@SPEC.md に基づいて実装して」と指示

インタビューのやりとりでコンテキストが消費されているため、
クリーンな新セッションの方が実装品質が高くなります。

References

Original concept: https://x.com/trq212/status/2005315275026260309
Interview depth: https://x.com/trq212/status/2005315277828096030

More from this repository

same repository

camone-ralph-loop

kaijutale/claude-code

Run external Ralph Loop (Geoffrey Huntley method) with clean context per iteration. Supports Simple mode (single PROMPT.md) and Full Ecosystem mode (specs/, fix_plan.md, AGENT.md, plan/build prompts). Unlike the official ralph-loop plugin which uses Stop hooks (same session, context pollution), this spawns fresh `claude -p` sessions each iteration. Use when user mentions "camone-ralph-loop", "external ralph", "clean ralph loop", "外部ラルフ", "ラルフループ実行", or wants to run iterative AI development with isolated context windows.

2026-02-265

commit

kaijutale/claude-code

Execute semantic git commits with individual file staging, prefix selection, and split-commit enforcement. Use when committing code, managing git history, or when user mentions git/commit/push.

2026-02-265

generating-gitignore

kaijutale/claude-code

Detect project tech stack and generate a comprehensive, production-grade .gitignore. Covers 15+ languages, 20+ frameworks, security patterns, modern tooling, and monorepo support.

2026-02-265

installing-project-mcps

kaijutale/claude-code

Install MCP servers into the current project scope using claude mcp add. Use when setting up a new project, when user mentions MCP setup, project MCP, MCPインストール, MCPセットアップ, or /installing-project-mcps.

2026-02-265

launching-gtr-issue-worktree

kaijutale/claude-code

Create a git worktree via gtr (git-worktree-runner) for a GitHub issue and generate a CLAUDE.local.md with issue context so that Claude Code launched in that worktree knows what to work on. Issue-specific context is written to CLAUDE.local.md (not .claude/CLAUDE.md) to avoid Git conflicts when merging PRs from multiple worktrees. Use when user mentions "gtr issue", "issue worktree", "issueでworktree", "issueに着手", "gtr-issue", or wants to set up an isolated worktree for a specific GitHub issue. Requires: gtr (git-worktree-runner) and gh CLI installed.

2026-02-265

boris

kaijutale/claude-code

Claude Code workflow tips from Boris Cherny (creator of Claude Code) and the Claude Code team. Use when: setting up Claude Code, optimizing workflows, running parallel sessions, configuring CLAUDE.md, using skills/commands, subagents, hooks, MCP integrations, or learning best practices. Covers: git worktrees, plan mode, verification, permissions, Slack MCP, BigQuery, prompting tips, plugins, custom agents, sandboxing, keybindings, status lines, output styles, and customization.

2026-02-235

name

spec-based-development

description

Spec-Based Development

AskUserQuestionToolでフェーズ制インタビューを実施し、Agentが自律実装可能な精度のSPEC.mdを生成する。

Workflow

Task Progress:

Step 1: アイデア把握
Step 2: 既存SPEC.md確認
Step 3: フェーズ制インタビュー実施
Step 4: SPEC.md書き出し
Step 5: 次ステップ案内

Step 1: アイデア把握

ユーザーの入力から対象機能・プロジェクトの概要を把握する。情報が不足していても問題ない（Step 3で掘り下げる）。

Step 2: 既存SPEC.md確認

プロジェクトルートに SPEC.md が存在するか確認する。

存在する場合: 内容を読み込み、既存の仕様を踏まえてインタビューする
存在しない場合: 新規作成前提で進む

Step 3: フェーズ制インタビュー実施

5フェーズで段階的に深堀りする。各フェーズの開始時に現在のフェーズ名をユーザーに伝えること。

フェーズ概要:

概要・ゴール（3-5問）: 目的、ターゲットユーザー、成功指標、スコープ境界
技術的実装（10-15問）: アーキテクチャ、データ設計、API設計、状態管理、外部依存
UI/UX（5-10問）: 操作フロー、状態遷移、レスポンシブ、アクセシビリティ ※該当時のみ
エッジケース・非機能要件（5-10問）: 異常系、セキュリティ、パフォーマンス、運用
トレードオフ・未決定事項（3-5問）: 技術選定理由、MVP境界、既知のリスク

各フェーズの詳細な質問パターンは references/interview-phases.md を参照。

CRITICAL: インタビュールール:

明らかな質問はしない。ユーザーが考慮していなかった深い部分を掘り下げる
1回のAskUserQuestionToolで1-4問ずつ質問する
大きな機能では最低40問以上質問すること
ユーザーが「完了」「十分」「もういい」と言うまで継続する
技術フェーズでは特に深く掘り下げる（DB選定で終わらず、インデックス戦略・キャッシュ無効化・トランザクション境界まで）

Step 4: SPEC.md書き出し

インタビュー結果をプロジェクトルートの SPEC.md に書き出す。

フォーマットは references/spec-template.md を参照。ハイブリッド型テンプレートを使用し、以下を必ず含める:

機能要件: 各要件にAcceptance Criteria（チェックボックス形式）
実装タスク: フェーズ分割・依存関係・完了条件付き

セクションは機能の性質に応じて調整する。不要なセクションは省略してよい。

Step 5: 次ステップ案内

SPEC.md作成後、以下を案内する:

SPEC.mdを作成しました！

次のステップ:
1. SPEC.mdの内容を確認・修正してください
2. 実装は新しいセッションで行うのがおすすめです:
   - /clear でコンテキストをリセット
   - 「@SPEC.md に基づいて実装して」と指示

インタビューのやりとりでコンテキストが消費されているため、
クリーンな新セッションの方が実装品質が高くなります。

References

Original concept: https://x.com/trq212/status/2005315275026260309
Interview depth: https://x.com/trq212/status/2005315277828096030