1仕組みと動作原理
徹底した規律を持つ「方法論エグゼキューター」：SKILL.md の本体はプロンプトのテクニックではなく、判定可能なワークフロー（ベースライン固定→シグナル選別→階層化→verbatim 移行→完全一致検証→ホスト環境での実測検収）であり、全工程に逸脱防止ガードレールが組み込まれています。
daymade-claude-code/claude-md-progressive-disclosurer/SKILL.md
**目标是让指令在实际任务中被正确加载、找到并执行。** 信息效率、可读性与可维护性服务于这个结果；文件大小、审阅次数和脚本绿灯都不能替代行为证据。
冒頭で検収基準をファイルサイズではなく「振る舞いのエビデンス」と定義し、後述する「行数を KPI にしてはならない」という鉄則の基礎としています。
鉄則：行数は最適化の目標ではない。判断基準は単一情報源（SSOT）、認知適合性、保守の一貫性であり、「X 行から Y 行へ削減／Z% 圧縮」を成果として報告することは明示的に禁止されています。
daymade-claude-code/claude-md-progressive-disclosurer/SKILL.md
- 行数少不代表更好，行数多不代表更差 - 评判标准是：**单一信息源**（同一信息不在多处维护）、**认知相关性**（当前任务不需要的信息不干扰注意力）、**维护一致性**（改一处不需要同步另一处）——不是行数
一般的な「CLAUDE.md 軽量化」スキルとの最大の違い：脱 KPI を鉄則化し、事例（15/16/19）を用いて行数削減がいかに情報損失を招くかを実証しています。
2層アーキテクチャ＋階層より媒体選定を優先：L1↔L2 の階層化を決める前に、まずルールを適切な格納先（常駐 L1 / reference / Skill / hook / ツールインデックス）へルーティング。「違反時の回復可能性 × トリガーの自己報告性 × ツールイベントの可観測性」マトリクスで常駐から外せるかを判定します。
daymade-claude-code/claude-md-progressive-disclosurer/SKILL.md
**先问载体，再问层级。** 判据是模型能否在决策前找到这条规则，以及现有机制能否覆盖所需条件。下表是候选路由，不证明机制已存在，也不授权安装新机制。
マトリクスの3行（自己報告トリガー／イベント可観測／両方なし）で Skill、reference、hook 通知、常駐 L1 の選択を決定。hook は発生時点のみを通知し、判断はモデルに委ねる点を強調しています。
機械的な切り出しはスクリプトが実行：`sink_sections.py` が spec に従ってセクション全体（fence を認識した高精度な見出し境界判定）を verbatim で reference に追記し、L1 の該当箇所を圧縮スニペットに置換。行番号のズレを防ぐため「抽出先行・置換後続・ボトムアップ」を徹底し、バイト単位の完全一致検証を行い、失敗時は自動でロールバックします。
daymade-claude-code/claude-md-progressive-disclosurer/scripts/sink_sections.py
extract [start_heading, end_heading) from the source (exact-line match, code-fence-aware) -> append verbatim to the target reference under a dated provenance header (new files get an intro) -> replace the L1 range with the compressed snippet, bottom-up so earlier line numbers stay valid -> verify every original is a WHOLE-BYTE-STRING substring of its target
SKILL Step 3 では 3 セクション以上の手動移行を禁止しスクリプト化を義務付け。スクリプトの OK 出力は機械的チェックの通過を示すのみであり、意味的欠損がないことまでは保証しません。
完全性の検証はバイト単位の完全一致を基準とする：セクション全体が移行されたかの確認に `grep` は使用不可（行単位の OR 判定では欠落を見落とすため）であり、`python3` による文字列全体の部分一致判定が必須。圧縮要約に対しても節単位の diff（「/forks」等の修飾語の欠落）を検証します。
daymade-claude-code/claude-md-progressive-disclosurer/SKILL.md
**不能用 grep** —— 原句多行时 `grep -F` 按行 OR，**丢半段照样报命中**， 必须用 python3 整串子串判断
「偽のポインタは内容の喪失よりも検知しにくい」：Step 4 ではポインタを記述する前にリンク先に実体が存在するかをその場で検証し、空ファイルへの参照を禁止します。
計測ツールに fence 認識および CJK トークン比率補正を内蔵：`profile_claude_md.py` はセクション別バイト数、行長分布、最長行を出力し、CJK トークンにおける「文字数/4」の推計を明示的に拒否（実測値は約 0.42 token/byte）。
daymade-claude-code/claude-md-progressive-disclosurer/scripts/profile_claude_md.py
Token estimates: chars/4 UNDERESTIMATES CJK-dense files by >2x. Measured ratio on a real CJK-heavy CLAUDE.md was ~0.42 tokens/byte.
スクリプト先頭には実測で判明した落とし穴（見かけ上 45.9KB のセクション、トークンの過小評価）が記録されており、既知のサンプルで計測器の事前キャリブレーションを要求します。
ホストごとの挙動差を明確に区別：Claude の `@import` は起動時に全展開され（コンテキスト節約にならない）、`.claude/rules` は常駐、`paths` はファイルマッチングで発火。Codex の AGENTS 階層とトークン予算は `codex debug prompt-input` で別途実測し、一方のホストの挙動を他方に当てはめることを禁止します。
daymade-claude-code/claude-md-progressive-disclosurer/SKILL.md
`@path` import 在**启动时全量展开载入**——拆成 `@import` 只改善组织，**不减少任何上下文**（官方 *memory* 文档原文）
同一の制約は references の事例 11 にも記載。参照形式は 4 種から選択し、原則 2 に従い参照には必ずトリガー条件の付記を義務付けています。
2コア機能
01読み取り専用の監査／ホットスポット計測：セクション別バイト数一覧、行長分布（1KB 超の巨大行の特定）、fence 認識見出し解析
02シグナルの選別：各セクションに Anthropic litmus テスト（「削除すると誤りを犯すか」）を適用し、真のシグナルと逆シグナルを選別
03セクション全体の verbatim 切り出し（`sink_sections.py` による spec 駆動、複数セクションの一括機械移行＋ロールバック）
04セクションごとのコンテンツ完全性検証（5b）と、圧縮要約に対する節単位の忠実度監査（expected-hunks-only `difflib` チェック）
05偽ポインタ防止のハードゲート：「詳細は X を参照」と書く前にリンク先に内容が存在するかをその場で検証（存在確認は `grep -F` による固有文字列抽出、完全性は `python3` の完全一致判定）
06ホストの実際の読み込みサーフェス検証：`/context`、`/memory`、`InstructionsLoaded` hook、`codex debug prompt-input` による実測
3外部依存関係
| Kind | Dependency / Endpoint |
|---|---|
| cli | python3 |
| cli | codex（官方 CLI，仅调试读取 prompt 注入） |
| cli | claude（/context、/memory、InstructionsLoaded hook） |
4推奨統制措置と判定根拠
安全運用のための推奨統制措置
Agent 向け
段階的・都度認可、サンドボックス推奨
管理者向け
承認フロー、ロールバック可能、全履歴監査
判定根拠（ファイルパスと抜粋）
- scripts/: ローカルスクリプトまたはコマンドの実行: scripts/profile_claude_md.py
- 本地工作目录: ファイルの読み書きおよび成果物の出力: ユーザーの CLAUDE.md/AGENTS.md 本体（変更が明示的に許可された場合のみ）
監査ノート： 内蔵スクリプトは標準ライブラリのみで構成（'Stdlib-only by design (skill scripts must run with no installs)'）され、完全にローカルで動作：`profile`/`markdown_headings` は読み取り専用。`sink_sections` はバックアップ、ロールバック、シンボリックリンク越境防止、完全一致検証を備えた安全なローカル書き換えを行います。外部通信やクレデンシャルの読み取りは行わず、settings や秘密情報ファイルには一切接触しません。書き込み対象はユーザーの CLAUDE.md/AGENTS.md のみであり、「管理対象ファイルへの可逆的なローカル変更」として扱われ、SKILL 自体の権限境界によってエージェントの行動が厳格に制約されます。
5二重目の独立検証
- [ok] 无网络外发 — 脚本零网络；md 中 https 全为 references 的官方文档/论文引用
- [ok] 无凭证读取 — 脚本无 environ/getenv/settings.json 读取
- [ok] sink_sections.py 写入面与 SKILL 声称一致（含备份、回滚、symlink 拒绝） — main() 实测：preflight abort 条件、copy2 备份、whole-string 校验失败恢复源文件均在代码中
- [ok] ‘行数禁作 KPI’纪律是否被脚本弱化 — profile_claude_md.py 输出分节字节表，但说明明确仅作工作顺序与诊断，不输出‘精简目标’
- [ok] 宿主机制断言（@import 全量展开、96KiB 截断）有依据 — 引用官方 memory 文档并标注历史事故作‘必须实测’示例，SKILL 反复要求以当前官方文档与真实宿主读回裁决
6結論
最適な用途： CLAUDE.md や AGENTS.md を「情報損失ゼロ」かつ検証可能な忠実度で体系的に再構成・軽量化したいメンテナーに最適。また、指示ファイルのガバナンス規律（マルチエントリ、SSOT、格納先ルーティング、検証基準）を確立したいチームにも適しています。特に、中国語や中英混合の指示ファイル（CJK トークン補正が必要なケース）や、Claude Code と Codex を併用するユーザーに適しています。
不向きな用途： 単に「ファイルを小さくしたい／行数を減らしたい」だけの短絡的な軽量化（鉄則により遮断されます）；明確な権限境界がなく、エージェントが「不要に見える」コンテンツを勝手に削除することを許容する環境；純粋なソースコードのリファクタリング（対象は指示ファイル限定）；低スペックモデルやコンテキスト長が短い環境での一連のプロセスの無差別な適用（コスト対効果が低いため）。
Install Agent-Ready
① Verified Mirror 2026-09-09
Option A · Direct DownloadDownload claude-md-progressive-disclosurer.tar.gz
sha256:
Option B · Copy Guide for Agent57ac229162c67d07…Agent はこの JSON ガイドから自動的にダウンロードして検証します。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit d5c4678cb5.