replace-with-skill-name-using-hyphens

スキル名

概要

[このスキルの基本原則を1～2文で説明します。このスキルの根本的な洞察は何ですか？]

使用するタイミング（トリガー）

• 症状：[このスキルが必要であることを示すエラー、動作、パターン]
• 状況：[このパターンが当てはまる具体的なシナリオ]

使用しないタイミング

• [シナリオ A] -> 代わりに[other-skill-name]を使用します。
• [シナリオ B] -> 該当しない理由は……

基本パターン

[メンタルモデルを説明します。判断プロセスが自明でない場合は、変更前と変更後のコードブロック、または小さなdotフローチャートを使用します。]

// ❌ Anti-pattern / Baseline failure
[Show the common mistake or naive approach]

// ✅ Best practice / Correct implementation
[Show the correct pattern]

ステップごとのワークフロー

[エージェントが実行する明確な手順を番号付きで示します。命令形の動詞を使います。]

1. [フェーズ 1]：[実行する操作]
2. [フェーズ 2]：[実行する操作]
   • 要件：[具体的な制約]
3. [フェーズ 3]：[実行する操作]

クイックリファレンス

[コマンド、構文、または一般的な操作をすばやく確認できる表です。]

操作 / シナリオ	構文 / コマンド	注記
[操作]	[Command]	[注記]

検証（成功基準）

[実装が正しいことを証明する方法（GREEN フェーズ）。エージェントはこれらの確認を実行する必要があります。]

• [検証項目 1。例：テストスイートを実行する]
• [検証項目 2。例：lint エラーがないことを確認する]

よくある間違いと危険信号

[エージェントが抱きがちな具体的な正当化、近道、誤解を列挙します。ここでは、RED フェーズにおける基本的な失敗に対処します。]

危険信号（言い訳 / 間違い）	実際の対応 / 修正方法
「今回はテストを省略してもいい。」	停止してください。 まず動作を検証する必要があります。
[間違いや言い訳]	停止してください。 [正しい対応]