# Code Forge

> 编程模式的默认编码工作流接线：1 个大脑 + 4 个专精子智能体（架构/编码/自检/审查）组成的编码流水线，从需求澄清（意图回读确认）、技术方案、编码实现、逻辑自检到审查验收与迭代修订。当用户在编程模式下说「开始开发/帮我实现…/设计方案/编码实现/自检代码/审查代码」时使用。这是随「编程模式」预设发行的基础接线技能，用户可通过 /set skill 修订出个人专属版本（项目级 .dsh/skills/ 下的同名技能优先）。可与 workflow-builder（工作流构建器技能）联合使用：workflow-builder 负责搭建/迭代工作流，本技能是其产出的编码领域接线成品。

- Skill: `tydm2/code-forge` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add tydm2/code-forge`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tydm2/code-forge/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: tydm2 (https://skillmd.com/u/tydm2)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/tydm2/code-forge

---


# 编码工作流（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 执行）

1. 新任务：读取 `agents/orchestrator/AGENT.md`（及 `agents/orchestrator/knowledge/*`），按其中协议用 `subagent` 派发大脑子代理澄清需求（含**意图回读确认**） → 产出 `outputs/tasks/task-NN.md` → 用户确认。
2. 「设计方案」：读取 `agents/architect/AGENT.md` 派发架构小组 → 产出 `outputs/designs/design-NN.md`（极简单任务可在澄清时要求跳过架构环节）。
3. 「编码实现」：读取 `agents/coder/AGENT.md` 派发编码小组 → 产出 `outputs/src/<task_id>/`。
4. 「自检代码」（coder 产出后 orchestrator 自动派发）：读取 `agents/self-checker/AGENT.md` 派发逻辑自检 → 产出 `outputs/selfchecks/selfcheck-NN.md`；passed 进入审查，打回则 coder 修订后复检（聚焦 P0/P1）。
5. 「审查代码」：读取 `agents/reviewer/AGENT.md` 派发审查小组 → 产出 `outputs/reviews/review-NN.md`（含对自检 VERIFY-BY-RUN 疑点的运行确认）；passed 即交付，打回则 coder 修订后复审（聚焦 P0/P1）。
6. 迭代：用户修改意见一律通过 `send_message` 续聊同一子代理（保留上下文，不重启）；修订写进对应产出文件的改动记录区。

## 硬性要求

- **省 token**：全流水线强制 `shared/token-economy.md` 十条铁律；派发提示词按需注入、截断聚焦；审查打回聚焦最小修改集；迭代一律续聊不重启。
- **文件契约**：task/design/meta/selfcheck/review 的元信息格式以根 README「四、文件契约」为准，各 AGENT.md 为引用而非复制。
- **意图精确**：orchestrator 澄清后必须先做**意图回读确认**（一句话回读需求与验收标准，用户确认后再组装任务包），拦截需求误解返工。
- **质量红线**：每个 AGENT.md 的验收标准逐条可勾选，不通过不出稿。

## 与 workflow-builder 联合使用

本技能是 [workflow-builder（工作流构建器技能）](https://github.com/tydm2/workflow-builder-skill) 的编码领域接线成品。两者关系与联合使用方式见仓库根 README「与 workflow-builder（工作流技能）的关系与联合使用」一节：workflow-builder 搭建/迭代工作流，本技能直接驱动编码任务并作为其参考蓝图。

## 安全与数据保护

- 权限：仅任务所需工具与文件；子代理提示词自包含，不注入主会话上下文。
- 密钥：任何 API key/token 一律走环境变量，绝不写入代码、日志、文档或产出文件。
- 数据：最小收集；涉及敏感或个人数据时脱敏处理，产出前复核。