메뉴
长文档治理 skill。当 post-change-check 报 [CRITICAL] 长文档警告，或用户主动要求"拆文档"、"文档太长"时触发。核心机制：增量治理（不主动拆现有文档，仅在对超长文档做实质修改时治理）、微改豁免、拆分预算退路。触发词："拆文档"、"文档太长"、"split doc"、"文档拆分"。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
从老旧黑盒代码反推「树形索引、逐层下钻」的知识库（业务逻辑/数据库/接口三层），给重构 AI 注入背景。承诺「边界内可审计覆盖 + 残余风险显式登记」，不承诺零遗漏。触发词：「老代码考古」「反推知识库」「重构前背景」「把老项目翻译成文档」「legacy 调查」。
对抗评审 skill。主线程把待评审内容（设计文档 / 代码 / 任意方案）原样打成证据包，并行起 Claude(Opus) 子线程与 codex(GPT 5.5) 做两份独立评审，再由 Opus 裁判逐条裁决采纳/驳回，产出最终报告。Claude 轮用 Agent 工具，GPT 轮用 codex。触发词："克劳德评审"、"对抗评审"。
Use when the user wants to consult Claude for a second opinion, audit, or direct execution. 触发词："问一下克劳德"、"问一下claude"、"问一下sonnet"、"让克劳德去做"、"让claude直接XX"、"问一下opus"、"让opus去做"。This skill uses the Agent tool to spawn a Claude subagent from the main thread. All synthesis and decisions stay in the main thread.
让 Opus 子线程处理最复杂的分析和执行任务。触发词："问一下opus"、"让opus去做"。主线程（L1）制包，Opus（L3）深度推理。
让 Sonnet 子线程分析或执行任务。触发词："问一下sonnet"、"问一下claude"、"让sonnet去做"、"让claude去做"。主线程（L1）制包，Sonnet（L2）深度推理。
从现有代码冷启动、生成七层文档反推总控文档的 skill（用户级通用）。本 skill 的交付物是「扫描摘要 + 任务总控编排文档」，不包含具体层的文档撰写（Phase 3 由 /control 驱动，单独消耗会话预算）。适用场景：项目无文档或文档严重过时、需要系统性规划七层文档补写任务。触发词：「冷启动建文档骨架」「反推文档体系总控」「从代码反推文档」「代码到七层」「反推文档体系」。
| name | long-doc-governance |
| description | 长文档治理 skill。当 post-change-check 报 [CRITICAL] 长文档警告，或用户主动要求"拆文档"、"文档太长"时触发。核心机制：增量治理（不主动拆现有文档，仅在对超长文档做实质修改时治理）、微改豁免、拆分预算退路。触发词："拆文档"、"文档太长"、"split doc"、"文档拆分"。 |
三种入口（任一成立即触发本 skill）：
post-change-check 输出了 [CRITICAL] 行且本轮有实质修改不触发：归档目录（05-归档/、06-05-归档/）下的文档；CLAUDE.md / AGENTS.md / SKILL.md 不受管控。
实质修改（触发治理）
微改（豁免）
自检方式：git diff --stat 看增删行数；语义增量 > 20 行 或 新增 H2/H3 → 实质修改。
反例（不能当微改）：重写一段 50 行的设计描述；把一个功能从一处搬到另一处；新增接口参数说明。
只对 docs/ 下业务文档生效；CLAUDE.md / AGENTS.md / SKILL.md 不扫描。
| 类型 | 覆盖范围 | 警告阈值 | 强制阈值 |
|---|---|---|---|
| 接口协议 / 测试 / Schema | *接口*、*数据库*、*schema*、04-测试/ 等路径模式（由项目自定义） | 600 行 | 1000 行 |
| 设计文档 / 总控 | 01-需求/、02-页面设计/、03-技术设计/、06-任务总控/（非归档）、施工蓝图、任务总控、技术方案 | 800 行 | 1500 行 |
扫描命令：bash ~/.claude/scripts/doc-length-check.sh --format human --scope <file>
拆分前先估算工作量：
预估时间 ≈ 目标文档行数 / 200 × 5 分钟
若 预估时间 > 主任务工作量 × 1.5 → 停下来问用户三选一，不要自作主张：
「
<文件名>共 X 行，拆分预估约 Y 分钟，主任务约 Z 分钟。建议： A. 先拆再做（一次付清） B. 单独排一个拆分任务，本次先改完 C. 本次例外，在任务级设计文档（轻量设计方案/任务总控）写明原因」
grep -n "^## " <file> # 列出所有 H2 标题与行号
wc -l <file> # 总行数
识别业务边界（按功能模块，不按行数）。
目标：每个子文件 < 警告阈值 × 70%。
拆分模板：
原文件: 03-01-前后端接口协议.md
↓
03-01-前后端接口协议/
├── 00-总览与公共约定.md ← 鉴权、错误码、分页、命名约定
├── 01-用户模块.md
├── 02-订单模块.md
└── 03-第三方集成.md
00-总览 列各子文件链接）NN-名称.md）# 全仓搜旧路径引用（.md / .java / .ts 均查）
grep -rn "旧文件名" . --include="*.md" --include="*.java" --include="*.ts"
逐个修复为新路径，确保 anchor 锚点仍然存在。
# 若项目存在文档层级检查门禁脚本（如 .claude/hooks/pre-commit-check.sh）则运行；没有则人工核对
bash .claude/hooks/pre-commit-check.sh
确认层级编号检查通过。
重构: 长文档治理 — 03-01-前后端接口协议 拆分为 03-01/ 子目录