用途
doc-refactor 用于重构文档：在不丢失信息的前提下对文档进行简化，并用 sequenceDiagram 可视化流程。它的触发关键词包括 refactor doc、simplify document、doc-refactor、condense document。
适用范围与不适用情况
该技能明确列出了不适用场景：不要用于代码重构（应使用 /simplify 或 /refactor）；不要用于不进行修改的文档评审（应使用 /codex-review-doc）；不要用于撰写新文档（应使用 /tech-spec 或 /create-request）。
主要能力
针对 $ARGUMENTS 指定的文件，任务包括：分析原始内容，统计行数，识别核心信息与冗余内容；执行重构，将长段落转为表格，将步骤转为 sequenceDiagram，将重复内容合并为单一来源；进行校验，确认关键信息保留且行数减少。
使用方式
技能会调度专用的 doc-refactor 代理，示例调用如下：
Agent({
description: "Refactor document — simplify without losing information",
subagent_type: "doc-refactor",
prompt: Refactor the document at: $ARGUMENTS Follow the task steps and simplification standards defined in this skill.
})
简化标准
不同文件类型的目标行数为：CLAUDE.md 少于 50 行；rules/.md 少于 30 行；agents/.md 少于 50 行。
输出格式
输出应包含重构结果与变更说明，格式如下：
Refactoring Result
- Original: X lines
- Simplified: Y lines (-Z%)
Changes
- <summary>