how
「X はどう動くのか」という質問、何かを変更する前のコードのウォークスルー、配置・所有・レイヤリングの質問(「これはどこに置くべきか」「どのパッケージがこれを所有するのか」「これは正しいレイヤーか」)に使う。サブシステムのアーキテクチャ、実行時のフロー、オンボーディング用のメンタルモデルを説明する。動機については why を使う。
- License 许可
- MIT
- 最近更新
- 2026-11-12
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- how
- description
- 「X はどう動くのか」という質問、何かを変更する前のコードのウォークスルー、配置・所有・レイヤリングの質問(「これはどこに置くべきか」「どのパッケージがこれを所有するのか」「これは正しいレイヤーか」)に使う。サブシステムのアーキテクチャ、実行時のフロー、オンボーディング用のメンタルモデルを説明する。動機については why を使う。
02 资源文件 2
- 参考文档references/explainer-prompt.md3.9 KB
- 参考文档references/explorer-prompt.md3.5 KB
03 SKILL.md 正文
How
コードベースを探索して「X はどう動くのか」という質問に答える。サブシステムにオンボーディングするシニアエンジニアの水準でアーキテクチャの説明を作る。動くメンタルモデルを組み立てるには十分で、注釈付きソースコードのように読めるほど多くはしない。
ディスパッチ契約。 設定済みのすべてのロールを provider-dispatch.md を通して解決する。値はプロバイダ修飾付きのディスクリプタであり、ネイティブ実行と外部実行のどちらにするかは親が選ぶ。Codex では、残りの Claude ツール名を codex-tools.md で解決する。
Step 1. 複雑さを見極める
スコープが曖昧なら、自分の解釈を述べてから探索する。ユーザーは軌道修正できる。
- 単純(単一のモジュール、小さなユーティリティ、「関数 X はどう動くのか」のような狭い質問): エクスプローラー(探索役)は使わない。エクスプレイナー(説明役)1 つが探索と説明を一度に行う。Step 2b へ進む。
- 複雑(複数のファイルやサービスにまたがるサブシステム、横断的な機能、アーキテクチャ全体の概観): まず並列のエクスプローラーを起動し、その後エクスプレイナーに引き渡す。Step 2a へ進む。
迷ったら単純な経路を取る。
Step 2a. 探索する(複雑な質問のみ)
質問を 2 から 4 個の探索の切り口に分解する。それぞれがサブシステムの別々の断面になるようにする。すべてのエクスプローラーをプロバイダディスパッチ経由で 1 回のファンアウトフェーズで起動する。設定済みの how-explorer ディスクリプタ(デフォルトは grok:grok-4.6@xhigh)を read-only モードで使う。ネイティブレーンは親のサブエージェントプリミティブを使い、外部レーンはランチャーを直接使う。
各エクスプローラーには references/explorer-prompt.md のプロンプトに、その切り口を埋めたものを渡す。その後 Step 3 へ進む。
Step 2b. 直接説明する(単純な質問)
設定済みの how-explainer ディスクリプタ(デフォルトは claude:fable@max)を使い、探索と説明を一度に行う読み取り専用レーンを 1 つディスパッチする。
そのプロンプトは references/explainer-prompt.md から、エクスプローラーの発見事項のセクションを除いて組み立てる。Step 4 へ進む。
Step 3. 統合する(複雑な質問のみ)
すべてのエクスプローラーが戻ってきたら、設定済みの how-explainer ディスクリプタ(デフォルトは claude:fable@max)を使い、それらの発見事項を 1 つの説明に統合する読み取り専用レーンを 1 つディスパッチする。
そのプロンプトは references/explainer-prompt.md に、すべてのエクスプローラーの発見事項を埋めて組み立てる。
Step 4. 提示する
エクスプレイナーの出力をユーザーに提示する。明確化や会話の文脈に合わせた軽い編集はよい。大幅に書き直してはならない。
出力形式
説明は references/explainer-prompt.md で定義されたセクションを使い、当てはまらないものは省く: 概要、主要な概念、動作の仕組み、ファイルの所在、落とし穴。
04 同仓库更多 Skills
why
「なぜ X はこの動きなのか」「なぜ Y を選んだのか」、設計の根拠説明、リグレッション、ポストモーテム、データに裏付けられたしきい値に使う。利用可能な MCP を発見し、各証拠カテゴリ(ソース管理、issue トラッカー、長文ドキュメント、リアルタイムチャット、インフラ可観測性、エラートラッキング、プロダクト分析ウェアハウス)を並列で問い合わせ、決定とトレードオフについて引用付きの読み解きを返す。実行時の振る舞いには how を使う。
what-did-i-get-done
ユーザーが指定した期間に自分が作成したコミットを、簡潔な状況報告に要約する
unslop
あらゆる文章から AI の痕跡を削る。常に適用しなければならない。
typescript-best-practices
TypeScript のベストプラクティス。.ts または .tsx ファイルを読むか編集するときに使う。
thermo-nuclear-code-quality-review
抽象化の質、巨大ファイル、スパゲッティ条件分岐の増殖について、極めて厳格な保守性レビューを行う。thermo-nuclear なコード品質レビュー、thermonuclear レビュー、深いコード品質監査、または特に厳しい保守性レビューに使う。
technical-writing
階層化されたテクニカルライティング標準。Diátaxis の構造、Google developer style の文、STE の指示ルール、Global English の構文。/technical-writing、またはドキュメント、RFC、readme、PR の説明、コミットメッセージを書いたりレビューしたりするときに使う。