| name | workflow-automation |
| description | 从 agent-workflows 库中选择并执行合适的工程工作流,覆盖项目初始化、功能开发、缺陷修复、代码评审、事故响应、重构和技术债清理;当 Codex 需要自动路由任务并直接执行对应步骤时使用。 |
工作流自动化
说明:通过把任务路由到正确的工作流并直接执行对应步骤,自动化使用 agent-workflows 库。
快速开始
执行规则
- 把工作流 Markdown 文件当作操作说明,而不是要原样转述给用户的说明文档。
- 一次只使用一个主工作流。如果任务跨越工作流边界,先完成或暂停当前工作流,再明确交接到下一个工作流。
- 如果用户明确指定了某个工作流,应尊重该要求;只有在明显不安全或不匹配时才覆盖,并解释原因。
- 保持上下文精简:加载
README.md、相关共享文档和选中的工作流文件即可。不要把所有工作流文件都读进来。
- 对会改代码的工作流,在仓库中直接执行对应步骤,包括验证和最终汇报。
- 对代码评审或仅调查式清理这类只读工作流,除非用户明确要求编辑,否则保持只读。
任务路由
当正确工作流不明显时,阅读 references/workflow-routing.md。默认映射如下:
- 新能力、设计变更或产品行为变更:功能工作流。
- 新项目、绿地代码库、仓库脚手架或初始工具链搭建:项目初始化工作流。
- 现有行为错误或回归:缺陷修复工作流。
- 用户要求 review、findings、PR review 或 diff review:代码评审工作流。
- 线上或刚发生的生产故障、缓解、告警或事故:事故工作流。
- 目标是在不改变行为的前提下改善结构:重构工作流。
- 清理、依赖升级、删除死代码、处理 TODO 或技术债盘点:技术债清理工作流。
如果分类存在实质性歧义,提一个简短澄清问题即可。如果歧义风险较低,选择最可能的工作流并说明你的假设。
定位工作流库
- 先运行
scripts/find_workflow_library.py --json,必要时相对当前技能目录解析脚本路径。
- 该脚本会依次检查
AGENT_WORKFLOWS_ROOT、脚本相对路径,再从起始路径向上查找。
- 如果脚本找到了库根目录,就直接使用它返回的路径。
- 如果没有找到库,不要猜测,直接向用户询问
agent-workflows 的路径。
执行工作流
- 打开文件前先阅读 references/library-loading.md。
- 运行工作流中的预检、安全规则、分诊门,以及当前任务真正需要的步骤。
- 同时遵守库里的共享约定和工作流专属规则。
- 处理事故时,优先缓解影响,并把破坏性操作视为需要批准的动作。
- 处理评审任务时,以“先给发现项”为默认方式,除非用户明确要求,否则不要编辑。
参考资料