用途:根据代码库与现有文档,为某个功能生成或更新发布运行手册(runbook-release.md),或对已有手册做只读过期校验。所谓运行手册即运维/发布人员实际执行的步骤集合。
主要能力:自动识别或指定目标功能;在创建模式下按“作用域发现”五级优先级(请求相关文件路径、current_authority、design_records、功能本地路径、仓库级 grep)逐节填充 9 段模板,并写入文档特性目录;在更新模式下解析嵌入的 provenance 清单,逐个比对来源文件的 SHA,仅重写过期段落;在检查模式下只读校验每段 SHA,输出 Fresh/Stale/Missing/Unknown 结论。生成内容会应用脱敏规则,用占位符替换密钥、带凭据的 webhook、内网端点与数据库连接串。
使用方式:命令形式包括 /runbook(自动识别功能,创建或更新)、/runbook <feature-keyword>(指定功能)、/runbook --update(强制更新)、/runbook --check(只读校验)、/runbook --request <path|title>(多请求功能时指定目标请求)。功能解析通过脚本完成,按是否带位置参数选择:node scripts/resolve-feature.js --feature <功能键> 或 node scripts/resolve-feature.js。该技能仅授予直接 node 调用权限,参数需作为独立 argv 传入,不可拼接进更复杂的 shell 表达式。
适用场景:需要为功能发布准备运维手册、部署清单、发布前检查或回滚计划,并在代码变更后保持手册同步时使用。
限制:扫描结果中的 scan_error 必须严格等于 false,否则视为来源集合未知并应停止,不能当作“无权威文档”继续。当功能存在多个活跃请求时需用户选择;无活跃请求时使用最近一条并给出警告。该技能不用于事故响应手册、代码审查、架构设计、技术方案写作或请求跟踪。--check 模式不修改任何文件。创建或更新会触发文档审查流程。具体模板细节、发现启发式与检查输出格式见对应引用文件;资料未提供收费、价格与平台信息。