القائمة
文档健康监测与深层知识发现：模块缺口、源码漂移、类型失衡、横切主题、角色视角、端到端旅程、故障路径、隐式耦合、时序分析、决策考古、运维暗知识。用 /doc-discover 启动。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
文档专家：以读者视角审视整个文档库的完整性、一致性和可导航性。从角色阅读路径、跨文档一致性、叙事完整度三个维度评估，产出战略级改进任务。用 /doc-expert 启动。
Autoresearch 文档研究循环。自主从任务队列中选取最高优先级任务，探索源码，撰写或改进文档。生成器角色，不自评。用 /doc-research 启动。
审计已有文档质量。对所有已完成文档用二元评分表逐项评定，为低分文档创建改进任务。用 /doc-review 启动。
استنادا إلى تصنيف SOC المهني
| name | doc-discover |
| description | 文档健康监测与深层知识发现：模块缺口、源码漂移、类型失衡、横切主题、角色视角、端到端旅程、故障路径、隐式耦合、时序分析、决策考古、运维暗知识。用 /doc-discover 启动。 |
文档体系的自动化健康检查工具，通过 13 种检测模式发现文档缺口、内容漂移和隐性知识需求，产出结构化任务进入 task-queue.yaml。
用户输入 /doc-discover 或要求「查找文档缺口」「检查文档健康度」「发现新文档需求」。
支持参数：
/doc-discover — 运行全部检测模式/doc-discover modules — 仅模块扫描/doc-discover drift — 仅漂移检测/doc-discover balance — 仅类型平衡分析/doc-discover themes — 仅横切主题发现/doc-discover depth — 仅深度审查/doc-discover personas — 仅角色视角分析/doc-discover verify — 仅待验证点汇总/doc-discover journeys — 仅端到端旅程发现/doc-discover failures — 仅故障与恢复路径发现/doc-discover coupling — 仅隐式耦合分析/doc-discover temporal — 仅时序与并发分析/doc-discover decisions — 仅决策考古/doc-discover tribal — 仅运维暗知识发现/doc-discover deep — 运行所有深层发现模式（8-13）STEP 0 — 建立基线
读取 $PROJECT_ROOT/_meta/documentation-gaps.md、$PROJECT_ROOT/_meta/task-queue.yaml
读取 $PROJECT_ROOT/docs/ 下所有已有文档的 YAML frontmatter 或首行标题
构建「文档 → 源码模块」映射（从 doc-research 的 $PROJECT_ROOT/_meta/source-path-mapping.md 获取）
STEP 1-13 — 按需执行各检测模式（见下方模式总览表）
STEP FINAL — 汇总报告
打印健康度仪表盘（见 references/output-format.md）
将新发现的任务写入 $PROJECT_ROOT/_meta/task-queue.yaml（读写协议见 $PROJECT_ROOT/_meta/task-schema.md，写入后须重新生成 task-queue.md）
追加记录到 $PROJECT_ROOT/_meta/research-log.md
详细步骤见 references/basic-modes.md。
| 模式 | 参数 | 说明 |
|---|---|---|
| 1 — 模块扫描 | modules | 检测源码中未被文档覆盖的新增模块 |
| 2 — 漂移检测 | drift | 检测文档写成后源码是否发生显著变更 |
| 3 — 类型平衡 | balance | 检测 Diataxis 四象限文档分布是否合理 |
| 4 — 横切主题 | themes | 识别跨模块反复出现的设计模式或架构主题 |
| 5 — 深度审查 | depth | 检测文档深度是否匹配源码模块规模 |
| 6 — 角色视角 | personas | 从不同角色视角审视文档缺口 |
| 7 — 待验证点 | verify | 汇总文档中的低置信度待验证点 |
详细步骤见 references/deep-discovery-modes.md。
| 模式 | 参数 | 说明 |
|---|---|---|
| 8 — 端到端旅程 | journeys | 识别跨多模块的完整用户/系统旅程 |
| 9 — 故障路径 | failures | 发现异常处理、重试、降级、恢复机制 |
| 10 — 隐式耦合 | coupling | 发现通过共享资源形成的模块间隐式依赖 |
| 11 — 时序并发 | temporal | 发现执行顺序、时间窗口、并发控制的隐式依赖 |
| 12 — 决策考古 | decisions | 从代码和 git 历史发掘设计决策的背景 |
| 13 — 运维暗知识 | tribal | 发现只存在于运维经验中的操作性知识 |
$PROJECT_ROOT/_methodology/06-priority-and-types.mdreferences/output-format.md必须先读取源码路径映射：不要直接扫描 $PROJECT_ROOT/src/ 目录结构。所有源码路径必须从 $PROJECT_ROOT/_meta/source-path-mapping.md 读取，该文件定义了项目特有的目录布局和模块划分规则。直接扫描会遗漏非标准路径或误判目录层级。
避免创建重复任务：创建任何新任务前，必须先检查 $PROJECT_ROOT/_meta/task-queue.yaml 中是否已存在覆盖相同模块或主题的任务（包括 pending、in-progress、done 状态）。重复任务会造成 doc-research worker 的浪费。
区分 doc-discover 与 doc-expert 职责：doc-discover 负责发现缺口和产出任务；doc-expert 负责文档库的战略评审和优先级调整。不要在 discover 流程中做战略层面的取舍判断，也不要在 expert 评审中执行缺口扫描逻辑。