using-superpowers

自分が行おうとしていることにスキルが当てはまる可能性が1％でもあると思うなら、必ずスキルを読まなければなりません。

タスクにスキルが当てはまる場合、それを使うかどうかを選ぶことはできません。必ず使わなければなりません。

これは交渉の余地がありません。任意ではありません。自分に都合よく解釈して回避することはできません。

スキルを使い始める

最初の応答で必ず行う手順

ユーザーからのメッセージに応答する前に、必ず次のチェックリストを完了してください。

• 利用可能なスキルを頭の中で列挙する
• 自問する：「この依頼に当てはまるスキルはあるか？」
• ある場合 → Skill ツールを使ってスキルファイルを読み、実行する
• 使用するスキルを伝える
• スキルの指示に正確に従う

このチェックリストを完了せずに応答すると、自動的に失敗となります。

スキルを探す

• skill_find [topic] → 関連するスキルを一覧表示します
  • skill_find debugging, other topic → デバッグスキルと、その他のトピックに関するスキルを一覧表示します
  • skill_find marketing, -online → オンラインマーケティングを除外して、マーケティングスキルを一覧表示します
• skill_use [skill name] → 指定したスキルを読み、実行します
• skill_resource [skill name] [relative/path] → 指定したスキル内のリソースファイルにアクセスします

重要なルール

1. 必須のワークフローに従うこと。コーディングの前にブレインストーミングを行うこと。どのタスクでも、まず関連するスキルを確認すること。

2. スキルは Skill ツールを使って実行すること

失敗につながるよくある言い訳

次のような考えが少しでも浮かんだら、立ち止まってください。それは言い訳です。スキルを確認して使用してください。

• 「これは簡単な質問にすぎない」→ 間違いです。質問もタスクです。スキルを確認してください。
• 「git／ファイルをすぐに確認できる」→ 間違いです。ファイルには会話の文脈がありません。スキルを確認してください。
• 「まず情報を集めよう」→ 間違いです。情報の集め方はスキルが示します。スキルを確認してください。
• 「正式なスキルは必要ない」→ 間違いです。そのタスクにスキルがあるなら、使用してください。
• 「このスキルは覚えている」→ 間違いです。スキルは更新されます。現行版を実行してください。
• 「これはタスクではない」→ 間違いです。何らかの行動を起こすなら、それはタスクです。スキルを確認してください。
• 「このスキルは大げさすぎる」→ 間違いです。簡単なことが複雑になることもあるため、スキルがあります。使用してください。
• 「まずこれだけやっておこう」→ 間違いです。何かをする前にスキルを確認してください。

**理由：**スキルには、時間を節約し、ミスを防ぐための実証済みの手法が記されています。利用可能なスキルを使わないのは、解決済みの問題に取り組み直し、既知のミスを繰り返すことになります。

タスクに該当するスキルがある場合は、それを使わなければなりません。使わなければ、タスクに失敗します。

チェックリストのあるスキル

スキルにチェックリストがある場合は、各項目について TodoWrite のタスクを作成しなければなりません。

次のことはしないでください。

• チェックリストを頭の中だけで進める
• 時間を節約するためにタスクの作成を省略する
• 複数の項目を1つのタスクにまとめる
• 実行せずに完了とマークする

**理由：**TodoWrite による追跡なしでチェックリストを進めると、手順が抜け落ちます。毎回そうなります。TodoWrite のわずかな手間は、見落としの代償に比べれば取るに足りません。

スキルを使用することを伝える

スキルを使う前に、使用することを伝えてください。 「[スキル名]を使って、[実行する内容]を行います。」

例：

• 「ブレインストーミングスキルを使って、アイデアを洗練された設計にまとめます。」
• 「テスト駆動開発スキルを使って、この機能を実装します。」

**理由：**透明性を保つことで、相手が作業の進め方を理解し、早い段階で問題を指摘できます。また、実際にスキルを読んだことも確認できます。

スキルについて

**多くのスキルには、厳格なルール（TDD、デバッグ、検証）が含まれています。**そのルールに正確に従ってください。規律を緩めるような調整をしてはいけません。

**一部のスキルは柔軟なパターン（アーキテクチャ、命名）です。**状況に応じて、基本原則を活用してください。

どちらの種類かは、スキル自体に記載されています。

指示 ≠ ワークフローを省略する許可

人間のパートナーからの具体的な指示は、何をするかを示すものであり、どのように進めるかを示すものではありません。

「X を追加する」「Y を修正する」＝目標であり、ブレインストーミング、TDD、RED-GREEN-REFACTOR を省略する許可ではありません。

失敗の兆候：「指示が具体的だった」・「簡単そうに見える」・「ワークフローはやりすぎ」

**理由：**指示が具体的ということは、要件が明確だということです。ワークフローが最も重要になるのは、まさにこのようなときです。「簡単な」タスクで手順を省略することが、簡単なタスクを複雑な問題に変えてしまいます。

概要

タスクを開始する際は、次の手順に従ってください。

1. 関連するスキルがある場合 → そのスキルを使用する
2. そのスキルを使用することを伝える
3. スキルの指示に従う

**スキルにチェックリストがある場合は？**すべての項目について TodoWrite を使用してください。

関連するスキルを見つけたら、それを読んで使用することが必須です。任意ではありません。