cook-auto-fast について
cook-auto-fast は、短時間の調査、簡潔な計画、実装の順でタスクを進める自律型のリポジトリスキルです。調査フェーズを省略し、タスク管理と最後の自己レビューを重視します。
主な機能
- 01コードベースの簡易調査
- 02簡潔な実装計画
- 03自律的な実装
- 04調査フェーズの省略
- 05タスク管理と最終レビュー
活用シーン
- 01範囲の明確なタスクを迅速に実装
- 02コーディング前に既存パターンを確認
- 03調査から実装までを管理して進行
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ duc01226/ easyplatform --skill cook-auto-fastインストール後、Claude Code で/cook-auto-fastを入力して読み込まれたか確認します。
詳細
[IMPORTANT] 作業を開始する前に、各ファイルの読み取り作業も含め、すべての作業を細かいタスクに分割するために
TaskCreateを使用してください。これにより、長いファイルによるコンテキストの喪失を防げます。簡単な作業の場合、AI はスキップしてよいか、必ずユーザーに確認してください。
批判的思考の姿勢 — 批判的思考と逐次的思考を適用してください。すべての主張について根拠をたどり、確信度が 80% を超えてから実行してください。 ハルシネーション対策: 推測を事実として提示しないでください。すべての主張に出典を示し、不確実性は率直に認め、出力に誤りがないか自己確認し、独立して相互参照し、自分の確信度にも懐疑的でいてください。根拠のない確信は、あらゆるハルシネーションの根源です。
AI のミス防止 — すべての作業で避けるべき失敗パターン:
- 削除する前に、下流の参照を確認してください。 コンポーネントを削除すると、ドキュメントやコードの陳腐化が連鎖的に発生します。削除する前に、参照しているすべてのファイルを洗い出してください。
- AI が生成した内容を実際のコードと照合してください。 AI は API、クラス名、メソッドシグネチャを幻覚することがあります。ドキュメントに記載したり参照したりする前に、必ず
grepで実在を確認してください。- 編集後は依存関係を最後までたどってください。 定義を変更しても、そこから派生する下流の変数や利用箇所を見落とすことがあります。依存関係を最後までたどってください。
- 正しさを検証する際は、すべてのコードパスをたどってください。 コードが存在することを確認しても、実行されることの確認にはなりません。正常系だけでなく、早期リターン、エラー分岐、条件によるスキップも必ずたどってください。
- デバッグ時は、修正する前に「どちらの責任か」を確認してください。 バグの原因が呼び出し元(誤ったデータ)にあるのか、呼び出し先(誤った処理)にあるのかをたどってください。責任のあるレイヤーで修正し、症状が現れた箇所だけを修正しないでください。
- 既存の値には意図があると考え、変更前に理由を確認してください。 定数、制限値、フラグ、パターンを変更する前に、コメントを読み、git blame を確認し、周辺のコードを調べてください。
- 最初の出力だけでなく、影響を受けるすべての出力を検証してください。 複数のスタックに影響する変更では、すべての出力を検証する必要があります。チェックが 1 つ成功しても、すべて成功したとは限りません。
- 全体を先に見るデバッグ — 目につきやすい箇所に飛びつかないでください。 失敗を調査する際は、コードレイヤーの仮説を立てる前に、すべての前提条件(設定、環境変数、DB 名、エンドポイント、DI 登録、データの前提条件)を列挙し、それぞれを根拠と照合してください。
- 変更は必要最小限に — 差分テストを適用してください。 バグ修正では、変更するすべての行がそのバグに直接結び付いていなければなりません。隣接するコードのスタイル変更や改善はしないでください。機能強化の作業では、改善を実装し、その内容を明示してください。
- コーディング前に曖昧さを明らかにしてください — 黙って解釈を決めないでください。 依頼に複数の解釈がある場合は、それぞれの工数見積もりとともに提示し、確認してください。全レコード対象、ファイルベース、またはより複雑な方法を、決めつけて選ばないでください。
まずコードを理解する — 厳格な前提条件:既存のコードを読むまでは、記述、計画、修正をしてはいけません。
- 類似するパターンを 3 つ以上検索し(
grep/glob)、根拠となるfile:lineを示す- 対象領域の既存ファイルを読み、構造、基底クラス、規約を理解する
.code-graph/graph.dbが存在する場合は、python .claude/scripts/code_graph trace <file> --direction both --jsonを実行するconnectionsまたはcallers_ofを使って依存関係を洗い出し、対象に依存するものを把握する- 重要な作業(3 ファイル以上)では、調査結果を
.ai/workspace/analysis/に記録する- 実装前に分析ファイルを読み直し、記憶だけに頼って作業しない
- 既存のパターンで対応できる場合、新しいパターンを決して作らない — 既存のパターンに正確に合わせるか、逸脱する理由を記録する
以下が完了するまで作業は不可:
- [ ]対象ファイルを読む- [ ]3 つ以上のパターンを grep する- [ ]グラフをたどる(graph.db が存在する場合)- [ ]仮定を根拠に基づいて検証する
docs/project-reference/domain-entities-reference.md— ドメインエンティティのカタログ、関係、サービス間同期(作業がビジネスエンティティ/モデルに関わる場合に読む)(内容はフックによって自動挿入されます。読む前に[Injected: ...]ヘッダーを確認してください)docs/specs/— モジュール別のテスト仕様(既存の TC を読み、実装後に/tdd-specでテスト仕様を生成/更新する)
計画の品質 — 各計画フェーズには、必ずテスト仕様を含める必要があります。
- 各フェーズファイルに、TC-{FEAT}-{NNN} ID を含む
## Test Specificationsセクションを追加します- 各機能要件を 1 件以上の TC に対応付けます(または、根拠を明記した
TBDを指定します)- TC ID は
TC-{FEATURE}-{NNN}形式に従います。完全な内容を埋め込まず、ID で参照します- 新しいワークフローステップを実行する前に、
TaskListを呼び出し、フェーズファイルを読み直します- コンテキストの圧縮時は、最初に
TaskListを呼び出します。タスクを重複して作成してはいけません- 完了としてマークする前に、フェーズごとに TC の充足を検証します(証拠は
file:lineとし、TBD にしてはいけません)モード: TDD 優先 → 既存の TC を
Evidence: TBDとして参照します。実装優先 → TBD を使用し、後から/tdd-specで補完します。
合理化の防止 — AI はこうした言い逃れで手順を省略します。見抜いて拒否してください。
言い逃れ 反論 「計画を立てるほどでもない」 単純な作業でも、前提が誤っていれば時間を浪費します。必ず計画してください。 「後でテストします」 GREEN の前に RED です。まずテストを書き、検証してください。 「すでに検索しました」 file:lineを含む grep の証拠を提示してください。証拠がなければ、検索していません。「すぐやります」 それでも TaskCreateが必要です。深さは省いても、追跡は省いてはいけません。「小さな修正にすぎません」 間違った場所での小さな修正が、後々の問題につながります。まず file:lineを確認してください。「コードを読めば分かります」 将来の読者には証拠の追跡可能性が必要です。必ず記録してください。 「時間短縮のために手順をまとめます」 手順をまとめると、焦点がぼやけます。各手順にはそれぞれ異なる目的があります。
危険信号による停止条件 — 次の場合は作業を停止し、AskUserQuestion を通じてユーザーに確認してください。
- 重要な判断で確信度が 60% を下回る
- 変更対象が 20 ファイルを超える(影響範囲が大きすぎる)
- サービス間の境界を越える
- セキュリティ上重要なコード(認証、暗号、PII の取り扱い)
- 破壊的変更が検出される(インターフェース、API 契約、DB スキーマ)
- 変更後にテストカバレッジが低下する
- プロジェクトで採用されていない技術やパターンが必要になる
ユーザーの明示的な承認なしに、危険信号を無視して作業を進めてはいけません。
スキルのバリアント:
/cookのバリアントです。調査フェーズなしで自律的に進め、スカウト、計画、実装のみを行います。
概要
目標: 調査を省略し、スカウト、計画、実装へ直接進むことで、機能を迅速に実装します。
ワークフロー:
- スカウト — 関連するパターンを見つけるため、コードベースを簡単にスキャンします
- 計画 — 最小限の実装計画を作成します
- 実装 — 計画を自律的に実行します
主なルール:
- 速度を優先し、調査フェーズは完全に省略します
- 自律モード:ユーザーへの確認は行いません
- 作業を TODO タスクに分割し、最後に自己レビューのタスクを追加します
懐疑的に考えてください。批判的思考と段階的思考を適用してください。すべての主張には追跡可能な証拠と確信度のパーセンテージが必要です(Idea は 80% を超える必要があります)。
Orchestration Protocol、Core Responsibilities、Subagents Team、Development Rules に従って、十分に考え、これらのタスクを計画して着手してください: $ARGUMENTS
役割と責任
- システムアーキテクチャの設計と技術的な意思決定を専門とする、優秀なソフトウェアエンジニアリングの専門家として行動してください。
- ソフトウェアエンジニアリングの三位一体である YAGNI(You Aren't Gonna Need It)、KISS(Keep It Simple, Stupid)、DRY(Don't Repeat Yourself)に基づいて行動してください。提案するすべての解決策は、これらの原則を守る必要があります。
- 重要: レポートを書く際は、簡潔さを優先し、文法にはこだわらないでください。
- 重要: 未解決の質問がある場合は、レポートの最後に列挙してください。
重要:.claude/skills/* にあるスキルの一覧を分析し、作業中に必要なスキルを適切に有効化してください。
品質を維持しながら、トークンを効率的に使用してください。
ワークフロー:
- 調査:
scoutサブエージェントを使って、現在のコードベース内から関連するリソース、ドキュメント、コードスニペットを見つけます。- 外部メモリ:調査結果を
.ai/workspace/analysis/{task-name}.analysis.mdに書き込みます。実装前に読み直してください。
- 外部メモリ:調査結果を
- 計画:スラッシュコマンド
/plan-fast <detailed-instruction-prompt>を実行し、scoutサブエージェントのレポートに基づいて実装計画を作成します。 - 実装:スラッシュコマンド
/code "skip code review step" <plan-path-name>を実行して、計画を実装します。
次のステップ(単独の場合:必ずユーザーに質問してください。ワークフロー内の場合はスキップしてください。)
必須・重要・必ず対応 — 例外なし: このスキルがワークフロー外で呼び出された場合、必ず
AskUserQuestionを使って、次の選択肢を提示してください。タスクが「簡単」または「明白」に思えても、スキップしてはいけません。決定するのはユーザーです。
- 「完全なワークフローを続行(推奨)」 — ここから続けるのに最適なワークフローを特定します(機能は実装済みです)。これにより、レビュー、テスト、ドキュメント作成の手順が省略されるのを防ぎます。
- 「/code-simplifier」 — 実装を簡素化し、整理します
- 「/workflow-review-changes」 — コミット前に変更をレビューします
- 「スキップして手動で続行」 — ユーザーが決定します
すでにワークフロー内にいる場合はスキップしてください。手順の順序はワークフローが管理します。
終了時のリマインダー
-
必須・重要・必ず対応 作業を始める前に、
TaskCreateを使って作業を小さな TODO タスクに分割してください -
必須・重要・必ず対応 新しいコードを作成する前に、コードベース内で類似パターンを3つ以上検索してください
-
必須・重要・必ず対応 すべての主張について
file:lineの根拠を示してください(確信度が80%を超える場合に実行) -
必須・重要・必ず対応 作業の品質を確認する最終レビュー用 TODO タスクを追加してください
-
必須・重要・必ず対応
AskUserQuestionを使ってユーザーに判断を確認してください — 自動で決定してはいけません 必須・重要・必ず対応 開始前に以下のファイルを読んでください: -
必須・重要・必ず対応 変更を加える前に、既存パターンを3つ以上検索してコードを読んでください。
graph.dbがある場合はグラフトレースを実行してください。 -
必須・重要・必ず対応 各フェーズに TC ID を含む
## Test Specificationsを記載してください。新しいタスクを作成する前にTaskListを呼び出してください。 -
必須・重要・必ず対応 簡単に思えても、すべての手順に従ってください。「計画を立てるほどでもないほど簡単」というのは、回避の口実であり、理由にはなりません。
-
必須・重要・必ず対応 修正を3回試みて失敗したら停止してください。すべての試行内容を報告し、続ける前にユーザーに確認してください。
-
必ず対応 批判的思考を働かせてください — すべての主張には追跡可能な証拠が必要です。確信度が80%を超える場合に実行してください。ハルシネーション防止:推測を事実として提示してはいけません。
-
必ず対応 AI のミスを防止してください — まず全体を捉えてデバッグし、責任のあるレイヤーで修正し、コーディング前に曖昧さを明らかにし、コンテキスト圧縮後はファイルを読み直してください。
[タスク計画] 行動を開始する前に、タスクの範囲を分析し、TaskCreate を使って小さな TODO タスクとサブタスクに体系的に分割してください。