AGENT SKILL

how

「X はどう動くのか」という質問、何かを変更する前のコードのウォークスルー、配置・所有・レイヤリングの質問(「これはどこに置くべきか」「どのパッケージがこれを所有するのか」「これは正しいレイヤーか」)に使う。サブシステムのアーキテクチャ、実行時のフロー、オンボーディング用のメンタルモデルを説明する。動機については why を使う。

License 许可
MIT
最近更新
2026-11-12
Stars
★ 0
Forks
0

01 前言 Front Matter

name
how
description
「X はどう動くのか」という質問、何かを変更する前のコードのウォークスルー、配置・所有・レイヤリングの質問(「これはどこに置くべきか」「どのパッケージがこれを所有するのか」「これは正しいレイヤーか」)に使う。サブシステムのアーキテクチャ、実行時のフロー、オンボーディング用のメンタルモデルを説明する。動機については why を使う。

02 资源文件 2

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

seiei-sogen
seiei-sogen/agent-skills

why

「なぜ X はこの動きなのか」「なぜ Y を選んだのか」、設計の根拠説明、リグレッション、ポストモーテム、データに裏付けられたしきい値に使う。利用可能な MCP を発見し、各証拠カテゴリ(ソース管理、issue トラッカー、長文ドキュメント、リアルタイムチャット、インフラ可観測性、エラートラッキング、プロダクト分析ウェアハウス)を並列で問い合わせ、決定とトレードオフについて引用付きの読み解きを返す。実行時の振る舞いには how を使う。

★ 0
seiei-sogen
seiei-sogen/agent-skills

what-did-i-get-done

ユーザーが指定した期間に自分が作成したコミットを、簡潔な状況報告に要約する

★ 0
seiei-sogen
seiei-sogen/agent-skills

unslop

あらゆる文章から AI の痕跡を削る。常に適用しなければならない。

★ 0
seiei-sogen
seiei-sogen/agent-skills

typescript-best-practices

TypeScript のベストプラクティス。.ts または .tsx ファイルを読むか編集するときに使う。

★ 0
seiei-sogen
seiei-sogen/agent-skills

thermo-nuclear-code-quality-review

抽象化の質、巨大ファイル、スパゲッティ条件分岐の増殖について、極めて厳格な保守性レビューを行う。thermo-nuclear なコード品質レビュー、thermonuclear レビュー、深いコード品質監査、または特に厳しい保守性レビューに使う。

★ 0
seiei-sogen
seiei-sogen/agent-skills

technical-writing

階層化されたテクニカルライティング標準。Diátaxis の構造、Google developer style の文、STE の指示ルール、Global English の構文。/technical-writing、またはドキュメント、RFC、readme、PR の説明、コミットメッセージを書いたりレビューしたりするときに使う。

★ 0