القائمة
TRIGGER when: アプリケーション・新機能・CLI・API・画面などの新規作成依頼を受けたとき、実装や plan 作成に着手する前に発火する。ユーザーへの質問で仕様を drilldown し、どのモデルが実行しても同じ成果物を実装できるレベルの詳細仕様書を作ってから実装に進む。明確な bugfix や仕様が既に十分詳細な依頼では使わない。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | spec-drilldown |
| description | TRIGGER when: アプリケーション・新機能・CLI・API・画面などの新規作成依頼を受けたとき、実装や plan 作成に着手する前に発火する。ユーザーへの質問で仕様を drilldown し、どのモデルが実行しても同じ成果物を実装できるレベルの詳細仕様書を作ってから実装に進む。明確な bugfix や仕様が既に十分詳細な依頼では使わない。 |
作成依頼を受けた時点の要求は通常曖昧である。いきなり実装を始めず、質問によって仕様の曖昧さを削り、どのモデル・どのセッションが実行しても追加質問なしで同じ成果物に到達できる詳細度の仕様書 を作ってから実装フェーズへ進む。
以下の場合はこの skill の質問ループを省略してよい:
仕様書は「どのモデルが実行しても同じ成果物に到達する」ための文書である。未検証の技術前提を仕様書に書くと、実装フェーズでそれが実現不可能と判明したとき、実装モデルが仕様にない回避策を独自に発明し、仕様と成果物が乖離する。これを防ぐため、drilldown 時点で以下を行う:
質問は下記カテゴリを網羅的に検討し、実装の分岐に影響するものだけ を聞く:
| カテゴリ | 決めること |
|---|---|
| 目的・ユーザー | 誰が何のために使うか、解決したい課題 |
| 入出力 | 入力の形式と具体例、出力の形式と具体例 |
| データ | データモデル、永続化の要否、スキーマ、既存データとの関係 |
| 技術スタック | 言語、framework、実行環境、依存してよい外部サービス |
| インターフェース | 画面構成・操作フロー、CLI ならサブコマンド/フラグ体系、API ならエンドポイント設計 |
| エラー・エッジケース | 異常入力・失敗時の挙動、バリデーション、リトライ |
| 非機能 | 性能、データ量の規模、認証/認可、並行実行 |
| スコープ | 今回やらないこと、将来対応でよいこと |
仕様が完成したと言えるのは以下をすべて満たすとき。1つでも欠けるなら質問するか、ユーザーの許可を得た明示的な仮定で埋める:
docs/spec/<slug>.mdアプリケーションの作成/開発時に参照する全般に適用される方針。互換性より最適な実装を優先する。実装完了時にlint/format/build/testの実行と結果報告を行い、再利用可能な学びはskillへ反映する。
TRIGGER when: creating or editing .tsx/.jsx files, creating or editing React components, writing JSX with conditional rendering, or modifying pages/layouts in Next.js. Enforces zod/mini validation, shared UI conventions, and React best practices including Activity for show/hide, useEffect restrictions, and component patterns.
TRIGGER when: creating or editing .ts/.js/.mts/.mjs files, creating Node.js CLI tools, or modifying package.json. Enforces coding style, module conventions, package.json standards, and Node.js CLI tool patterns.
TRIGGER when: git repository で状態確認、branch 作成、差分確認、commit、rebase、push、worktree 作成、cleanup などの git 操作全般を行うとき。特にコード変更を伴う作業では repository root checkout を作業場所にせず、repository root 配下の `.worktree/` に専用 worktree を作って編集・test・lint・build・commit を完結させる。
Use when fetching data from Google Spreadsheets via the spreadsheet-cli tool. Read-only: the CLI has no write command. For write requests, report the limitation and propose an alternative.
作業中に見つかった学びを既存skillへpatchすべきか、新しいskillを作るべきか、durableな記録だけで十分かを判定するときに使う。再利用可能性・影響範囲・鮮度・記録先を切り分けるための基準。