quality-sync($quality-sync)是 Maestro Flow 工作流体系中的代码库文档同步技能,核心用途是追踪 git diff 的影响范围,并据此同步项目文档。\n\n主要能力:通过 doc-index.json 的层级关系(文件→组件→功能→需求)定位受影响的文档条目并重新生成;在依赖清单变化时刷新技术栈信息;输出受影响文件、组件、功能及更新文档的汇总报告并给出下一步路由建议。\n\n使用方式(命令保持原样):\n$quality-sync\n$quality-sync "--since HEAD~5"\n$quality-sync "--full"\n$quality-sync "--dry-run"\n$quality-sync "--since abc123 --dry-run"\n\n参数说明:--full 为忽略 git diff 的全量重同步;--since <commit|HEAD~N> 指定基线提交(默认上次同步时间戳);--dry-run 仅显示将要更新的内容而不写入。\n\n适用场景:需要让代码库文档跟随代码变更保持同步的 Maestro Flow 项目。\n\n限制:所有文件写入必须仅针对 .workflow/codebase/、.workflow/state.json 或 doc-index.json,绝不修改源代码或 .workflow/ 之外的文件;--dry-run 必须抑制所有写入。流程含强制阻断门:无 diff 且未指定 --full 时报告 W001 并退出;追踪失败则阻断;未更新文档不得报告完成。若 .workflow/ 不存在会抛出 E001 错误,需先运行 $maestro-init。其他细节资料未提供。
quality-sync
编程与开发
更新于 10-15 20:11