Oh My Taiyiforge

v1.1.0智能体编排

oh-my-taiyiforge

TaiyiForge — OpenCode 插件 + Claude/Codex/Cursor 共用 taiyi-* 九阶段研发工作流

维护活跃

#opencode #opencode-plugin #taiyiforge #claude-code #codex #cursor

GitHub 仓库 npm 页面官方主页

GitHub 星标

885

月装机量

近 7 天 20

综合评分SCORE

54.9

生态多维模型

快速安装与配置

opencode.json

写入当前项目的 opencode.json，只对这个仓库生效。

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["oh-my-taiyiforge@1.1.0"]
}

opencode 启动时会通过内嵌运行时自动加载 npm 依赖并缓存至本地目录，无需手动在全局环境执行安装。

README.md

查看原始文件→

English · 简体中文

TaiyiForge（太一炉）

把 AI 写代码的玄学，变成一条可执行、可审计的工程流水线。

TaiyiForge 架构

快速开始 · 核心能力 · 文档 · 社区

为什么需要 TaiyiForge？

用 AI 写代码很简单。用 AI 做工程很难。

你遇到的问题	根因
Agent 跳过需求/设计，直接写代码	没有阶段约束，AI 总会走捷径
长会话上下文爆炸，之前写的全丢了	没有 token 管理机制，上下文就是消耗品
Claude / Codex / Cursor 各一套流程	同一特性四套仪式，按工具入职不按团队
没人敢让 AI 独立拍板	没有门控的 review 形同虚设
装好的 Skill 实际行为没人说得清	文档漂移，出问题没法追溯

TaiyiForge 的回答：一套九阶段工件契约 + 状态机引擎。在四套 AI 终端里行为完全一致。

/taiyi:plan 默认半自动（拆模块 + 推荐 profile，人确认后批量 /taiyi:new）；切到 auto 模式即可一键生成全栈骨架（见下方"一键生成"小节）。不用背阶段顺序，不用记工件模板。

演示

27 秒终端实录。从零创建一个 change，引擎自动推进阶段：

终端演示

_{注：/taiyi:new → /taiyi:status → /taiyi:write → /taiyi:continue，四步走完一个阶段。}

快速开始

# 1. 安装
npm install oh-my-taiyiforge

# 2. 同步 Skill 到你的 AI 终端（Claude / Cursor / OpenCode / Codex）
npx taiyi-forge-install --all

# 3. 在聊天里创建第一个 change
/taiyi:new "优化登录流程"
/taiyi:status

# 或者：把整份需求丢给 /taiyi:plan，让引擎一次性拆出全部模块
/taiyi:plan README.md           # 也可以是 PRD.md / PDF / URL
# → 自动生成 examples/<项目>/agent/{backend,frontend}/ 全栈骨架（见下方"一键生成"小节）

你只管写 Markdown 和代码。阶段顺序、工件模板、门控校验全是引擎的活。

# 只装某一端
npx taiyi-forge-install --cursor
npx taiyi-forge-install --claude --opencode

# 源码安装
git clone https://github.com/Dong90/oh-my-taiyiforge.git
cd oh-my-taiyiforge && npm install && npm run build
node scripts/taiyi-forge.sh install --all

详细安装 →

核心能力

九阶段流水线

每次变更顺序走九步，每步固定产出。关键节点 人类门控——AI 不能放行自己。

change → requirement → design → ui-design → task → dev → test → review → integration
   ↑人类审批            ↑人类审批                                   ↑人类审批

阶段	产出	拍板
change	方案 + 范围边界	人
requirement	验收标准 + AC	引擎
design	≥2 方案对比 + 决策	人
ui-design	UI/UX 契约	引擎（仅触 UI 时）
task	可独立 PR 的片段	引擎
dev	TDD 先红后绿	引擎
test	测试证据摘要	引擎
review	跨 AI 评审	人
integration	交付门控	引擎

完整流程 →

一套命令，四端通用

不管是 Claude Code 的 /taiyi:new、Cursor 的同名 slash、Codex 的 $taiyi-new，还是 OpenCode 的插件工具——同一套词汇，同一种行为。

v30 推荐顶栏（21 条）：

组	命令
项目 (1)	`/taiyi:plan [file]` — README/PRD/PDF/URL → 多个 change
主链 (6)	`/taiyi:new` · `/taiyi:status` · `/taiyi:write` · `/taiyi:continue` · `/taiyi:apply` · `/taiyi:archive`
会话 (4)	`/taiyi:pause` · `/taiyi:pause --resume` · `/taiyi:cancel` · `/taiyi:list`
排查 (2)	`/taiyi:verify` · `/taiyi:render`
交付 (3)	`/taiyi:commit` · `/taiyi:ship` · `/taiyi:land`
伞形 (5)	`/taiyi:skill <name>` · `/taiyi:token …` · `/taiyi:test …` · `/taiyi:review …` · `/taiyi:diagram …`

21 条完整命令表 →

项目级 vs Change 级

层级	入口	做什么	产出
项目级	`/taiyi:plan`	把大需求拆成模块 + 推荐 profile + 处理冲突	批量 `/taiyi:new`
Change 级	`/taiyi:new`	单模块走九阶段	CHANGE → CHANGELOG

`/taiyi:plan` 一键生成的全栈骨架（auto 模式）

/taiyi:plan 默认半自动——拆完模块后等人确认再批量 /taiyi:new。auto 模式则一口气把后端、前端、测试、迁移全跑完，单条命令生成可直接跑的全栈工程。

下面就是 auto 模式一次产出的真实结构（examples/translation-assistant/agent/，79 文件 / 23 目录）：

agent/
├── backend/                          # FastAPI 后端
│   ├── app/
│   │   ├── main.py                   # 入口
│   │   ├── controllers/v1/           # HTTP 层（路由 + 校验）
│   │   ├── services/                 # 业务编排（LLM 调用、缓存、限流）
│   │   ├── strategies/               # ≥2 策略可替换（同步 / 异步 / 流式翻译）
│   │   ├── repositories/             # 数据访问
│   │   ├── models/                   # ORM / Schema
│   │   ├── middleware/               # auth / logging / ratelimit / cors
│   │   ├── adapters/                 # 外部服务接入（LLM provider、Redis）
│   │   ├── tasks/                    # 异步任务
│   │   ├── db/  cache/  telemetry/  core/  config/  # 横切关注点
│   │   └── alembic/env.py            # 迁移入口
│   └── tests/
│       ├── test_controllers.py test_services.py test_core.py
│       ├── test_models.py test_adapters.py test_strategies.py
│       └── integration/  performance/  e2e/         # 三层测试套件
└── frontend/                         # 前端
    ├── index.html                    # 入口
    ├── app.js                        # 业务逻辑
    ├── style.css                     # 样式
    └── metrics.js                    # 前端指标上报

对应九阶段工件：每个模块在 .taiyi/changes/<slug>/ 产出 {phase}.json + hbs 渲染的 CHANGE.md → … → CHANGELOG.md（本地可见，默认不提交仓库）。

怎么跑：从需求文件开始

/taiyi:plan README.md --auto         # auto 模式：一键骨架
/taiyi:plan PRD.pdf --profile=full   # 半自动：拆模块后等人确认

完整示例 → · plan 命令参考 →

不止流水线

强制 TDD：dev 阶段先红后绿，不是建议是硬约束
evidence 防假过门：每个 AC 必须配可执行验证命令，跑不过不放
token 压缩：长会话自动产出 CONTEXT-COMPACT.md，跨天无缝续上
ChangeGraph：自动追踪变更间依赖，改一处知全局
不搞一刀切：大功能 full，小修复 lite，typo 改 nano
5 个插件式 Registry（v1.0.0-rc.1）：Profile / CodePattern / SSOTRule / Extractor / RunnerPolicy 统一为 Registry<T> 抽象，支持 builtin + YAML + node_modules 三种扩展源，老 API 保持兼容。详见 CHANGELOG。

对比

	直接跟 AI 对话	TaiyiForge
流程约束	靠 prompt 和记忆祈祷	状态机强制推进
人类审批	看心情，容易跳过	`--approver` 硬拦，不批不放
多工具一致性	换工具换流程	同一套 Skill
上下文持久	丢了重新聊	token 压缩 + 断点续传
灵活度	全靠自觉	10 种 profile，按需选择

文档

文档	内容	什么时候读
QUICKSTART	5 分钟走通全流程	第一次用
nine-phase-flow	九阶段步骤、过关命令、profile 跳过	跑某一阶段时
USAGE	日常节奏、场景、交付链	跑通之后
ARCHITECTURE	系统架构 + 代码布局	想改引擎
canonical-commands	21 条 slash 命令表（v30 顶栏）	查命令
examples/translation-assistant/agent/	`/taiyi:plan --auto` 一次产出的全栈骨架	想要代码长什么样
control-plane	Agent 纪律 + token 纪律	给 Agent 配 onboarding
full-oss-flow	Superpowers + 全插件端到端	想看完整流程
CONTRIBUTING	贡献指南	开 PR 之前
CHANGELOG	发布说明	查更新

社区

🐛 报告 Bug
💡 想法 & 讨论
🔧 贡献代码 — npm test 必须绿
⭐ Star 一下，下次发布不迷路

TaiyiForge 不发明新标准——它把 Harness · OpenSpec · GStack · Superpowers · OMO · Spec-Kit 编排成一台状态机。装了什么用什么，其余自动跳过。

许可证

灵感来源：oh-my-claudecode · oh-my-codex · Harness Engineering · OpenSpec · GStack · Superpowers · OMO · Spec-Kit

Oh My Taiyiforge

快速安装与配置

TaiyiForge（太一炉）

为什么需要 TaiyiForge？

演示

快速开始

核心能力

九阶段流水线

一套命令，四端通用

项目级 vs Change 级

`/taiyi:plan` 一键生成的全栈骨架（auto 模式）

不止流水线

对比

文档

社区

许可证

Magic Compact

Matrixx

Herdr

快速安装与配置

TaiyiForge（太一炉）

为什么需要 TaiyiForge？

演示

快速开始

核心能力

九阶段流水线

一套命令，四端通用

项目级 vs Change 级

/taiyi:plan 一键生成的全栈骨架（auto 模式）

不止流水线

对比

文档

社区

许可证

`/taiyi:plan` 一键生成的全栈骨架（auto 模式）