编码工作流(code-forge 接线)
本技能把「编程模式」接到 code-forge 多智能体工作流。工作流根目录:当前工作区的 code-forge/(如 E:\ds harness\code-forge\);若当前工作区不存在,先在工作区创建该目录结构再使用。完整流水线图、文件契约与社区先例见根目录 README.md,各环节细则见各 agents/*/AGENT.md。
流水线
用户一句话(「帮我实现…」/「开始开发」)
│
▼
orchestrator(大脑·调度)──澄清需求(选项式提问)──▶ outputs/tasks/task-NN.md ──▶ 用户确认
│ 派发自包含任务包(design_mode: full / skip)
▼
architect(架构设计·小组)──研究门禁+技术方案──▶ outputs/designs/design-NN.md ──▶ 用户确认
│
▼
coder(编码实现·小组)──逐子任务实现──▶ outputs/src/<task_id>/(代码 + meta.md)
│
▼
self-checker(逻辑自检·单一专家)──静态推演判断逻辑正确性──▶ outputs/selfchecks/selfcheck-NN.md
├── passed ──▶ reviewer(审查测试·小组)──两阶段审查──▶ outputs/reviews/review-NN.md ──▶ 交付
└── rejected(P0/P1)──▶ coder 修订 ──▶ 复检(只聚焦上轮 P0/P1)
触发词映射表(唯一权威登记处:工作流根 README「二、触发词映射表」)
| 智能体 | 一句话职责 | 触发词(自然语言,含同义变体) |
|---|---|---|
| orchestrator(大脑) | 吃需求 → 吐已确认任务包 → 派发 → 汇总交付 | 开始开发 开始编码 新建项目 帮我实现… 做一个功能 修复bug 重构代码 写个脚本 |
| architect | 吃 task → 吐技术方案与任务分解 | 设计方案 架构设计 技术方案 出方案 拆任务 |
| coder | 吃 design/task → 吐可运行代码 + meta.md | 编码实现 落地代码 实现方案 写代码 |
| self-checker | 吃代码 → 静态推演判断逻辑是否正确 → 自检报告与判定 | 自检代码 逻辑自检 检查逻辑 自检 self-check |
| reviewer | 吃代码+自检报告 → 吐两阶段审查报告与判定 | 审查代码 代码审查 测试 验收 review |
触发规则:新任务(无对应 task 存档)一律先进 orchestrator 澄清(含意图回读确认);下游直达词只对「已确认上游产出」生效——缺上游时会被引导先跑对应环节。触发词互不冲突,也不与系统内置命令冲突。
派发协议(主 Agent 执行)
- 新任务:读取
agents/orchestrator/AGENT.md(及agents/orchestrator/knowledge/*),按其中协议用subagent派发大脑子代理澄清需求(含意图回读确认) → 产出outputs/tasks/task-NN.md→ 用户确认。 - 「设计方案」:读取
agents/architect/AGENT.md派发架构小组 → 产出outputs/designs/design-NN.md(极简单任务可在澄清时要求跳过架构环节)。 - 「编码实现」:读取
agents/coder/AGENT.md派发编码小组 → 产出outputs/src/<task_id>/。 - 「自检代码」(coder 产出后 orchestrator 自动派发):读取
agents/self-checker/AGENT.md派发逻辑自检 → 产出outputs/selfchecks/selfcheck-NN.md;passed 进入审查,打回则 coder 修订后复检(聚焦 P0/P1)。 - 「审查代码」:读取
agents/reviewer/AGENT.md派发审查小组 → 产出outputs/reviews/review-NN.md(含对自检 VERIFY-BY-RUN 疑点的运行确认);passed 即交付,打回则 coder 修订后复审(聚焦 P0/P1)。 - 迭代:用户修改意见一律通过
send_message续聊同一子代理(保留上下文,不重启);修订写进对应产出文件的改动记录区。
硬性要求
- 省 token:全流水线强制
shared/token-economy.md十条铁律;派发提示词按需注入、截断聚焦;审查打回聚焦最小修改集;迭代一律续聊不重启。 - 文件契约:task/design/meta/selfcheck/review 的元信息格式以根 README「四、文件契约」为准,各 AGENT.md 为引用而非复制。
- 意图精确:orchestrator 澄清后必须先做意图回读确认(一句话回读需求与验收标准,用户确认后再组装任务包),拦截需求误解返工。
- 质量红线:每个 AGENT.md 的验收标准逐条可勾选,不通过不出稿。
与 workflow-builder 联合使用
本技能是 workflow-builder(工作流构建器技能) 的编码领域接线成品。两者关系与联合使用方式见仓库根 README「与 workflow-builder(工作流技能)的关系与联合使用」一节:workflow-builder 搭建/迭代工作流,本技能直接驱动编码任务并作为其参考蓝图。
安全与数据保护
- 权限:仅任务所需工具与文件;子代理提示词自包含,不注入主会话上下文。
- 密钥:任何 API key/token 一律走环境变量,绝不写入代码、日志、文档或产出文件。
- 数据:最小收集;涉及敏感或个人数据时脱敏处理,产出前复核。