SuperAPI AI 工具集

ln-313-review-docs-worker

写作与研究

查看项目

更新于 10-15 23:59

技能介绍

用途:作为 L3 Worker,在评估运行中创建缺失的、评审所需的文档,仅用已验证的变更更新既有文档,并把文档工作与合并、修复分离。

主要能力:模式门控(mode=story 走完整文档流水线:域提取、模式检测、文档生成;mode=plan_review 无文档增量时跳过并记录 docs_skipped_reason)。运行族为 evaluation-worker-runtime,manifest 必填 identifier、phase_order、summary_kind=review-docs、operation=docs。推荐阶段顺序为 PHASE_0_CONFIG 到 PHASE_6_SELF_CHECK。

用法:阶段1从 Story 标题、技术说明、实现任务中提取技术域,形成有界文档主题列表;阶段2从 domain_patterns.md 加载模式注册表,按关键词检测模式,命中多个则全部生成;阶段3对每个模式检查目标路径 glob docs/{type}s/{pattern}.md 是否已存在,缺失则加载 references/templates/ 下的 adr_template.md、guide_template.md、manual_template.md,用可用 MCP 工具研究主题,ADR 模式先内部回答 Context、Decision、Consequences、Alternatives、Status 五个问题,生成规则为文档无代码、优先表格、目标 300-500 词,保存到 docs/{type}s/{naming}.md;阶段4把新建文档链接加入 Story 技术说明并更新运行时状态 docs_checkpoint;阶段5输出 summary_kind=review-docs,payload 含 worker=ln-313、status、operation=docs、warnings,并优先提供 docs_created、docs_updated、docs_skipped_reason、patterns_detected;阶段6自检,若无模式命中但技术面缺文档,按 Fallback Strategy 使用 MCP Ref 兜底。

适用场景:评估流程中需要文档产出与摘要的场景。限制:mode=plan_review 无增量则跳过;完成标准为文档目标已解析、模式检测已执行、文档变更已应用或说明跳过、摘要已写、自检通过。版本 1.0.0,最后更新 2026-04-10。