别让AI乱写代码了——用Smithy-AI把Claude Code变成可治理的开发流水线

你有没有这种感觉——让 AI 写代码,它倒是写得很爽,但代码质量、架构规范、代码审查,这些全靠人肉盯着,累死了?

Smithy-AI 解决的就是这个问题。

这是一个「AI 开发流程编排器」,核心思路很简单:把你团队的开发流程写成 YAML,Smithy 按规则执行,Claude Code 当执行者,人在关键节点拍板。

它是怎么工作的?

你在 GitHub/GitLab/Forgejo 或 Jira 上建一个 Issue,指派给 Agent Smithy,它就动起来了:

  1. Smithy 拉起一个 Docker 容器,把代码仓库克隆进去
  2. Claude Code 开始规划——根据你的 Issue 写实现方案
  3. 方案发回 Issue 评论区,等你审核
  4. 你打上 “Plan Approved” 标签,Smithy 才继续
  5. Claude Code 写代码、开 PR,你的 CI 通过后它还能自动回复 Review 评论

整个流程由 YAML 工作流定义,节点清晰、状态可控。随时可以中断、重启、覆盖——重启后从上次停下的步骤继续,不丢上下文。

核心能力一览

四种开箱即用的 Workflow:

  • smithy-development:单仓库任务的标准流程——计划 → 审批 → 实现 → PR → 审查回复
  • architect-review:自动对照团队规范审核 PR,给出结构化评审意见
  • architect-learn:把 Review 评论里的讨论沉淀为新的规范文档,自动提 PR 更新知识库
  • feature-coordinator:跨多个仓库的大功能协调——拆解任务、驱动子任务按依赖顺序执行

Docker 隔离:每次运行都在干净容器里,不污染宿主机,凭证和代码分离。

Human in the Loop:gate.await 让 Agent 在关键步骤停下来等你确认,不会自顾自把代码塞进去。

适合谁用?

如果你团队在用 Claude Code / Codex 做开发,Smithy-AI 可以把 AI 编程从「单次对话」升级成「可治理的工作流」。尤其适合:

  • 多仓库协作的大工程(feature-coordinator 协调跨仓库依赖)
  • 有代码规范要求的团队(architect-review 自动对齐规范)
  • 想积累团队知识资产的 CTO(architect-learn 把 Review 对话变规范文档)

怎么装?

官方 Demo 用 Docker Compose 起一个本地 Forgejo 实例练手:

cd examples/demo
cp .env.example .env
# 编辑 .env 填入 CLAUDE_CODE_OAUTH_TOKEN
docker compose up -d
python3 scripts/setup_instance.py
python3 scripts/setup_repo.py owner/repo

然后去建个 Issue 指派给 Smithy,看它怎么跑完整个流程。

GitHub:https://github.com/smithy-ai/smithy-ai


GitHub: https://github.com/smithy-ai/smithy-ai

评论区

0 条评论

登录后可评论。

陈一铭 53 阅读