st-create-plan について
st-create-plan は、作業依頼を構造化された計画にまとめる Strikethroo 向けエージェントスキルです。プロジェクトの情報を読み込み、重要な不明点を確認してから、テンプレートとフックに従って計画ファイルを作成します。
主な機能
- 01Strikethroo のルートを特定
- 02プロジェクト規約とテンプレートを読み込み
- 03重要な不明点を確認
- 04ID を割り当てて計画を作成
- 05計画後フックを実行
活用シーン
- 01新しい作業依頼の計画を作成
- 02計画前に未確定の要件を解消
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ e0ipso/ strikethroo --skill st-create-planインストール後、Claude Code で/st-create-planを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
scripts/check-for-updates.cjsfind-strikethroo-root.cjsget-next-plan-id.cjs詳細
st-create-plan
入力
ユーザーの依頼が作業指示となります。
実行手順
1. strikethroo のルートを特定する
ユーザーの作業ディレクトリで scripts/find-strikethroo-root.cjs を実行します。終了コードが 0 以外の場合は停止し、npx strikethroo init を実行するようユーザーに依頼します。
出力されたパスを、以降のすべての手順で <root> として扱います。
委任された実行ワーカーはこの手順をスキップし、更新通知も出しません。
このスキルのスクリプトパスを使い、scripts/check-for-updates.cjs "<root>" を別のコマンドとして実行します。ユーザーの作業ディレクトリを維持します。標準出力の 1 行の JSON を読み取ります。notice がある場合は、その正確なテキストを最終的なユーザー向け応答まで保持します。許可を求めて処理を中断してはならず、更新も実行してはなりません。
2. プロジェクトのコンテキストを読み込む
このプロジェクトのディレクトリ規約について、<root>/config/STRIKETHROO.md を読みます。
<root>/config/hooks/PRE_PLAN.md を読み、続行する前にその指示を実行します。
<root>/config/templates/PLAN_TEMPLATE.md を読み、計画はそのテンプレートに準拠させます。
また、<root>/config/shared/clarification-gate.md と
<root>/config/shared/anti-rationalization.md も読みます。
3. 作業指示を分析する
以下を特定します。
- 目的。
- 対象範囲と明示的な境界。
- 成功基準。
- 依存関係、前提条件、ブロッカー。
- 技術要件と制約。
4. 明確化のループ
重要なコンテキストが不足している場合は、ユーザーに的を絞った質問をします。質問がなくなるまで、これを繰り返します。後方互換性が必要かどうかを必ず明示的に確認します。回答を捏造したり、不足している回答を曖昧にごまかしたりしてはなりません。
ユーザーがブロッカーとなる質問への回答を拒否した場合は停止し、計画の作成には明確化が必要だと報告します。部分的な計画を作成してはなりません。
<root>/config/shared/clarification-gate.md の質問の進め方に従います。
<root>/config/shared/anti-rationalization.md を、この合理化防止テーブルに適用します。
| つい考えてしまうこと… | 拘束力のあるルール |
|---|---|
| 「妥当な答えを推測できる。」 | 推測は回答ではありません。質問し、回答を決して捏造してはなりません。 |
| 「もう一度尋ねるのは面倒だ。」 | ユーザーが回答を断れる質問は、後から対処できます。黙って誤った前提を置くことはできません。質問してください。 |
| 「ユーザーがほのめかしていたから、もう確定している。」 | ほのめかしは確認ではありません。質問として提示し、明確な回答を得てください。 |
5. 次の計画 ID を割り当てる
次に使用できる計画 ID を取得するために、scripts/get-next-plan-id.cjs を実行します。ディレクトリ名({padded-id}--{slug})に使うゼロ埋め形式を計算し、計画のフロントマターではゼロ埋めされていない整数を使います。
6. 計画を出力する
<root>/plans/{padded-id}--{slug}/plan-{padded-id}--{slug}.md に計画を書き、フロントマターとセクションの両方で <root>/config/templates/PLAN_TEMPLATE.md に準拠させます。時間の見積もり、タスクリスト、コードサンプルは含めません。それらはタスク生成の手順に含まれます。
計画の概要から <slug> を導きます。小文字の英数字とハイフンのみを使い、連続するハイフンを 1 つにまとめ、先頭と末尾のハイフンを取り除きます。
7. 計画後フックを実行する
<root>/config/hooks/POST_PLAN.md を実行します。
8. 構造化された要約を出力する
最後に、正確に次のブロックを出力します(保持している更新通知がある場合は、別途その後に続けます)。
---
Plan Summary:
- Plan ID: [numeric-id]
- Plan File: [absolute-path-to-plan-file]
この要約は後続の自動処理で使用されます。形式を正確に保ってください。
保持している更新の notice がある場合は、構造化された要約ブロックの後、またはこのスキルが要約ブロックを出力しない場合は最終応答の後に、その正確な文を追加します。通知の後には何も続けてはなりません。
失敗時の動作
- 割り当てられた ID の計画ディレクトリがすでに存在する場合。 次の計画 ID のスクリプトを再実行し、1 回だけ再試行します。競合が解消されない場合は停止して報告します。