内容
# 工匠
用于在 Claude Code 上构建最小化暗工厂的工匠工具包。你可以将小型、受控的代理步骤组合成一个确定的构建过程,该过程可以从头到尾阅读。模型负责具体工作,框架保持轻量。
由 [hackers&wizards](https://hackersandwizards.dev) 构建。我们已经花费了 20 多年时间构建和运行生产系统,并且我们教授函数式代理工程:用小型可组合步骤取代庞大的框架。工匠是这种实践在 Claude Code 工具链中的应用。
“暗工厂”是一种无人值守的生产流水线,它在没有人工干预的情况下运行。通常,要实现这一点,需要一个巨大的框架,而没有人能够理解它。工匠构建的是另一种类型的工厂:一种小到可以理解的生产线,模型负责思考,框架仅用于跟踪。
## 您构建的内容
`build-workflow` 插件一次搭建一个阶段。每个阶段都有一个带有门控的子代理,该门控会重新运行直到其检查通过,一个启动器技能可以在其上运行该阶段,以及一个工作流脚本行,将每个阶段的输出线程传递到下一个阶段。
一个完整的示例是 `examples/sdlc/` 中的 sdlc 线。一项功能请求输入,一个经过测试和接受的更改输出:
```
计划 -> 测试 -> 实现 -> 简化 -+-> 代码审查 -+-> 收敛 -> 验收 -> 报告
+-> 代码审查 --+ |
(实际问题?循环返回到实现,最大 3 次)
```
九个阶段。两个审查并行运行,收敛等待两者并在实际问题上循环返回。每个阶段都是几行代码,您可以阅读。编排是普通的 JavaScript 控制流,而不是一个黑盒。
## 安装
添加市场,然后安装插件:
```
/plugin marketplace add hackersandwizards/artificer
/plugin install build-workflow@hackersandwizards
```
## 构建一个阶段
```
/build-workflow <工作流> <顺序> <步骤>:角色 / 模型 / 工具 / 检查
```
例如,第一个阶段将功能请求转换为计划:
```
/build-workflow sdlc 1 计划:将请求转换为具有验收标准的计划 / opus, high / 读取, 写入 / true
```
每次调用都追加一个阶段。检查命令是契约:当其门控退出 0 时(测试通过,构建干净,审查完成),阶段完成。对于并行阶段,循环和升级,请直接编辑生成的 `.claude/workflows/<workflow>.js`。生成器将配方作为注释嵌入。
该插件还附带 `/improve-workflow`。它在真实输入上运行生成的 工作流,检查其假设是否成立(门控触发,结构化返回分支,并行阶段重叠),并将学习到的内容反馈到 工作流 和生成器模板中。
## 范围
工匠针对 Claude Code。 它构建的阶段是 Claude Code 代理,技能和工作流脚本。
## 仓库布局
```
.claude-plugin/marketplace.json 市场清单
plugins/build-workflow/ build-workflow 插件
examples/sdlc/ 使用 build-workflow 构建的暗工厂
```
## 许可证
MIT。参见 [LICENSE](LICENSE)。