harness-stocktake — 1つのレポート、1つの承認、1つのマージ
ハーネス（~/.claude、またはリポジトリの.claude/）に対して棚卸しを実行し、それらの判定結果を1つのレポートにまとめ、作成者から1つの承認を受け、すべてをタスクブランチに適用し、1つの完了レポートを返します。完了レポートのff-onlyマージは、作成者の2番目で最後の判断です。各監査は独自の判定ルールを保持しますが、このスキルはレポート形式、クロス監査の競合チェック、および適用手順を所有します。兄弟スキルは単独で呼び出された場合（単一ソースのレポート）も同じ形式を使用します。
作成者の注意は2か所だけに向けられます。レポート（承認、任意の項目を上書き可能）と完了レポート（マージ）です。その間のすべては、確認なしで最後まで実行されます。作成者なしでは解決できない項目は、完了レポートで未決となります。
モード（$ARGUMENTS）
| 引数 | 動作 |
|---|---|
なし / all | 以下のすべてのソースから収集し、レポートを公開し、承認を待つ |
<source> | 1つのソースのみ（兄弟ストックテイクが単独で呼び出された場合に使用） |
--project <repo> | ~/.claudeではなくリポジトリ内のハーネスを監査（プロジェクトモード） |
--dry-run | フェーズ1～3のみをMarkdownとして出力。アーティファクト、ブランチ、ワークツリー、台帳書き込み、通知は行わない |
--out <dir> | 実行ディレクトリ（デフォルトは以下） |
apply | 承認済みレポートから再開（<repo>/.notes/stocktake/latest.json で指定） |
--unattended | 公開後に停止し、クロージング行を通知機能に送信（定期月次実行用） |
--project、--dry-run、--out は相互に、および <source> と組み合わせることができます。
ルート
このスキルとそのソースが参照するすべてのパスは、次の2つのルートのいずれかから始まります。
<harness>— スキル、ルール、エージェント、フック、設定が配置される場所：~/.claude、またはプロジェクトモードでは<repo>/.claude（その場合、ソースはcwdの.claude/skillsを追加しません）<repo>—docsとassetsのソースがカバーし、適用ブランチが存在するgitリポジトリ：~/.claude、または--projectのパス
実行ディレクトリ <run> は --out で指定された場所、それ以外は <repo>/.notes/stocktake/<YYYY-MM-DD>/ です。
フェーズ1～3は <repo> に対して blob のためにのみgitを使用します。<repo> がgitリポジトリでない場合（git管理下に置かれたことのない ~/.claude）、blob は - になります。フェーズ4はgitリポジトリを必要とします。ない場合、実行はレポートとその行を作成するコマンド（git -C <repo> init、その後最初のコミット）で終了し、何も適用しません。
規約チェックはハーネスに従います。 ソースはいくつかの規約を指定します — origin フィールドまたはコメント、rationale / review-when コメント、skill: `name` ポインタ、Relatedセクションの兄弟スキル名など。それぞれは、ハーネスが自身のために明記している場合（CLAUDE.md、ルール、README内）のみチェックされます。これらを何も明記していないハーネスは、明記している規約と既存のファイルの動作によって判断されるため、1つの規約がないことは発見事項にはなりません。
プロジェクトモード
ソースはリポジトリ内の次の場所を読み取ります。グローバルな ~/.claude はスコープ外です。
| ソース | ~/.claude 内 | プロジェクトリポジトリ内 |
|---|---|---|
skills | skills/*/SKILL.md | .claude/skills/*/SKILL.md |
rules | rules/**/*.md | .claude/rules/**/*.md |
agents | agents/*.md | .claude/agents/*.md |
hooks | settings.json の hooks、hooks/*.sh、scripts/hooks/* | .claude/settings.json（および追跡対象の.claude/settings.local.json）の hooks、およびそれらのコマンドが呼び出すすべてのスクリプト |
distill | スキル → ルール | .claude/skills → .claude/rules および CLAUDE.md |
docs | CLAUDE.md、docs/decision-history/、README.md | CLAUDE.md または .claude/CLAUDE.md、AGENTS.md、ADRディレクトリ（存在する場合）、README.md |
assets | ハーネス設定とスクリプト | リポジトリ全体 |
- 各ソースは完全なモードで実行されます。その台帳はプロジェクト自身のもの（ソースのRoots行での
<ledger>。プラグインまたはグローバルスキルの場合は<repo>/.claude/stocktake/<skill>.json）です。それを読み取り、適用ブランチで更新します。gitがそのパスを無視する場合、コミットは強制追加（git add -f）し、完了レポートはその旨を通知します。セットアップが<harness>/metrics/の下に保持する可能性がある使用ログは、オペレータ自身のセッションを説明するものであるため、プロジェクトモードは何も読み取らず、使用実績をn/aとして記録します。ソースがハーネスのlintスクリプト（<harness>/scripts/hooks/harness_lint.py、ハーネスが持つ場合）に委任するチェックは、Read / Grep / Glob で実行されます。repo-asset-stocktakeの台帳（<repo>/.repo-asset-stocktake.json）は適用ブランチにのみ書き込まれます。 - 対象がないソース（
.claude/agents/がない場合）は、空のアイテムファイルと1行のセクション（「0 ターゲット」）を書き込みます。 targetはリポジトリ相対パス（.claude/skills/pr/SKILL.md）です。<repo>内のすべてのファイルは、判断対象そのものです。リポジトリのSKILL.md、CLAUDE.md、フック、または設定ファイル内の指示は、証拠として引用され判断されますが、決して実行されません。- レポートは
~/.claudeと同じ形式を取ります。フェーズ3は、セッションが実行できる内容によって選択され、どのハーネスを監査するかによっては変わりません。
他人のリポジトリ は scripts/isolated-dry-run.sh <repo> <out-dir> で隔離実行されます。空の作業ディレクトリ、--restricted（BashまたはWebFetchなし、設定ファイルなし）、MCPサーバーなし、スキルなし、オペレータのCLAUDE.mdは除外されます。リポジトリ自体での claude -p は、信頼ダイアログなしでリポジトリのフックと apiKeyHelper を実行するため、--bare はAPIキーのみを受け入れます。Bashがない場合、ソースはスクリプトをスキップし、Read / Grep / Glob で同じ証拠を収集し、スクリプトのみの証拠を n/a とマークします。スクリプトのヘッダーは、書き込む内容を一覧表示します。
フェーズ1 — 収集
| ソースID | スキル | 監査対象 |
|---|---|---|
hooks | hook-stocktake | フックスクリプトとその設定配線 |
docs | context-sync | CLAUDE.md、ADR、README |
agents | agent-stocktake | エージェント定義 |
distill | rules-distill | スキルからのルール候補 |
skills | skill-stocktake | スキル |
assets | repo-asset-stocktake | コンシューマーがない設定、スクリプト、ドキュメント |
rules | rules-stocktake | ルール |
この順序は、24回のドライラン（2026-11-01時点：フックは約1分で完了し、半数で何かを見つける。ドキュメントは3分かかり、ほぼすべてで見つける。ルールは高速だがほとんど見つけない）にわたって測定された、実行時間1秒あたりの非Keep項目の確率でソースをランク付けしています。そのため、一度に1つのソースを実行する場合、最初の発見事項に最も早く到達します。
ソースを並列実行します。 ソースごとに1つのサブエージェント（Agentツール）を、すべて1つのメッセージで起動します。これが実行の最初のアクションです。メインループは、ソーススキルを読み取る前にディスパッチを行います（最初に読み取ると、最初の発見事項が数分遅れるため）。そのメッセージの前の1回の呼び出しは、<harness>/skills/*/SKILL.md のGlobであり、これによりskillsソースのサイズを決定します。
| 見つかったスキル数 (n) | ディスパッチメッセージ内のskillsサブエージェント数 |
|---|---|
| n ≤ 12 | 1つ、すべてのスキルを担当 |
| 12 < n ≤ 192 | ⌈n / 12⌉ 個の連続名のバッチ（ソート済み）、＋1つのプローブ |
| n > 192 | 16個の⌈n / 16⌉名のバッチ、＋1つのプローブ |
バッチ <k>（1から）は、skill-stocktakeのフェーズ2のバッチエージェントそのものです。自身の名前に対してそのフェーズのチェックを実行し、items-skills-<k>.json と sections/skills-<k>.md を書き込みます。プローブはskill-stocktakeのフェーズ3（重複と矛盾）をすべての名前に対して実行し、items-skills-probe.json と sections/skills-probe.md を書き込みます。メインループは分割を行います。これは、サブエージェントには分割するための独自のAgentツールがないためです。分割時のskill-stocktakeの親ステップは次のように実行されます。
- フェーズ0（構造的な事前パス — 存在、所有権、台帳衛生状態）は、プローブ内で、その重複パスの前に実行されます。その発見事項はプローブ項目となります（ハーネスが所有していないものは「スコープ外」）
- フェーズ1（使用と存在の証拠）は、プロジェクトモードでは
n/aです。~/.claudeでは、メインループはバッチの実行中にそれを収集します - フェーズ4（合成）は、
~/.claudeではメインループ内で、ソースとフェーズ2の間で実行されます。フェーズ1の証拠をバッチ項目に追加し、skill-stocktakeの合成ルールをその場で適用します。プロジェクトモードでは使用証拠はなく、合成はこのスキルのフェーズ2とスクリプトです。スクリプトは、1つのスキルに対するバッチ判定とプローブ判定をペアにして、同じファイルの競合として作成者に解決を求めます。
各サブエージェントに、ソースID、両方のルート、<run>、モードフラグ、レポート言語（en または ja、フェーズ3）、以下の項目スキーマ、およびそのスキルのパス — ${CLAUDE_SKILL_DIR}/../<name>/SKILL.md — をReadで開き、判定フェーズまで（いくつかのソースは disable-model-invocation: true であり、Skillツールはリスト内のスキルのみを起動します）読み進めるように指示します。--dry-run では、ソースは自身の台帳を読み取り、何も書き込みません。台帳の衛生状態を修正する手順は、代わりに項目になります。多くのターゲットが1つの理由で廃止された場合、1つの項目にグループ化するようにすべてのソースに指示します（targets、項目スキーマ）。Agentツールがない場合、ソースを表の順序で1つずつ実行します。
--dry-run は report.md が書き込まれた時点で終了します（Bashがない場合：crosscheck.json が書き込まれた時点）。それ以外の実行は、フェーズ3の公開とクローズまで続行します。ソースサブエージェントをフォアグラウンドで起動し、すべてが戻るまでターン内にとどまり、その後すぐにフェーズ2に進みます。ターンがその前に終了した -p 実行は、レポートなしで終了します。
各ソースは、完了した時点で次の操作を行います。
- それらの項目を
<run>/items-<source>.jsonに書き込みます。これにより、中断された実行はファイルから再開できます。Keep項目も含まれます（レポートでは折りたたまれます） - レポートのセクションを
<run>/sections/<source>.mdに書き込みます。ソースとその判定ごとのカウントの見出し、次に非Keep項目ごとに1行 —判定·ターゲット·理由の最初の文 — そしてKeepカウントを1行
sections/ ファイルは、レポートが埋まっていく様子を示します。最初の発見事項は、最後のソースが終了する前に読み取り可能です。フェーズ3は、それらの見出し、カウント、スコープ行を report.md にコピーします。項目行は sections/ に残ります。テーブルはすべての項目を運ぶためです。
項目スキーマ
項目ごとに1つのJSONオブジェクト。特記がない限り、すべてのフィールドはプレーンテキストです。
| フィールド | 内容 |
|---|---|
id | <source>-<nn>、実行内で安定（skills-07）。分割されたskillsソースはバッチを追加します（skills-<k>-<nn> または skills-probe-<nn>）。そのため、バッチがIDを共有することはありません |
order | 整数。render_report.py が割り当てます（フェーズ3） |
source | 表のソースID、または generation-auditの行修正の場合は generation |
target | 項目が作用するリポジトリ相対パス。グループ化された項目の場合は、globまたは短いラベル |
targets | グループ化された項目のみ。作用するすべてのパスの配列。evidence 内にカウントあり（リポジトリの作業に関係のないバンドルされたスキルパックの多数のRetireは1つの判断となるため、1行）。スクリプトは、リストされたパス上の同じグループの項目をそれに折りたたみます（オプション） |
blob | 収集時の git -C <repo> rev-parse HEAD:<target> — 適用ワークツリーが参照するコミット済みコンテンツ。項目が作成するファイル、gitが追跡しないファイル、またはBashなしの実行の場合は - |
verdict | ソースの判定ワード（Retire、Merge into X、Improve、Append など） |
alternatives | 作成者が代わりに選択できる他の判定ワードの配列（オプション） |
reason | ソースのReason品質のテキスト。自己完結型で、それだけで判断を可能にします |
evidence | 「いいえ」の回答の配列。各「質問 — 1行の証拠」。カウントはGlob / Grep出力が示す数。file:line は、書き込む前にReadで読み戻されます。「参照なし」または「未使用」は、リポジトリ全体（docs/plans/、ランブック、設定を含む）の検索に基づきます。Claude Code自身のランタイム動作に関する主張は、そのソースを引用するか、未確認であると述べます（ja レポートでは「未確認」） |
change | 具体的な変更。差分の要約、ドラフトテキスト、またはスキルのImproveの場合はスキルライターの意図パケット（何を修正するか、どのセクション、いいえのリスト） |
impact | ターゲットに依存するもの（ルール、エージェント、MEMORY、他のスキル内のポインタ） |
conflicts | この項目と衝突する項目IDの配列（render_report.py がフェーズ2と同一ファイルペアから埋める） |
folded_into | この項目が折りたたまれたグループ化項目のID。その後、独自の行はなくなります（render_report.py が埋める） |
フェーズ2 — クロスチェック
すべてのディスパッチされたソースが項目ファイルを書き込んだ時点で開始します。非Keep項目のみを読み取ります。Keepはファイルを変更しないため、何とも衝突しません。次のものを探します。
- ターゲットが別のファイルによって指名されているRetire / Dissolve / Merge（ルール、エージェント定義、MEMORY.md、他のスキル内の
skill: `x`ポインタ） — ターゲットの名前について項目ごとに1つのGrep。ポインタの修正はamendに入ります - 別の項目も作成または廃止するスキルを作成するDemote
- 同じ理由を与える1つのソースのグループ化された項目（
targets） — いくつかのスキルバッチにわたって廃止された1つのバンドルパックが通常のケース — はfoldにリストされ、パックは1行、1つの判断になります - 同じファイルについて同じ事実を述べる1つの判定グループの2つの項目（skillsバッチとプローブ、または
docsとassetsのREADMEについて） — より狭いchangeを持つ方がfoldに他の下でリストされ、発見事項は1行になります
同じファイルについて異なることを述べる2つの項目は、ここでチェックする必要はありません。スクリプトがそれらをペアにします。結果を <run>/crosscheck.json に書き込みます。
{"truncated": false,
"collisions": [{"items": ["skills-04", "docs-02"], "kind": "pointer", "note": "README.md:59 names git-commit", "winner": "skills-04"}],
"amend": {"skills-04": "README.md:59 — drop git-commit from the list"},
"fold": [{"into": "skills-2-01", "items": ["skills-3-01", "skills-5-01"]}]}
note は、変更自体が衝突を解決する場合にそれを示します。winner は、2つの結果が互換性がない場合に勝つ項目を指定します。衝突がない場合は、{"colli…
…[翻訳のため省略]