Alloy

Alloy 是 AI 编码 Agent 的驾驶舱。 把需求管理（OpenSpec）和流程纪律（Superpowers）编成一条 5 阶段流水线——你只管 /alloy:start，剩下的编排、校验、归档全自动。

| 有 Alloy | 裸用 AI Agent | |----------|-------------| | 需求 → draft → specs，完整审计链 | "帮我加个功能"——需求在聊天里 | | 5 阶段 hard gate，脚本校验 | 无闸门，Agent 自由发挥 | | TDD + code review + 双层验证 | 靠 Agent 自觉 | | 任意阶段退出，回来随便打哪个命令都能接上 | 掉线从头开始 | | 做到一半改需求？编码未开始就回溯修正，已开始开新 change | 规格和代码分叉 | | 每次 change 结束自动复盘，教训反哺下次 | 每次都从零开始 | | 每个制品 hash 锁定 + 独立 commit，完整可追溯 | 改了什么都记不住 |

工作流

/alloy:start    [1/5]  智能入口 → 需求探索 → draft.md
/alloy:plan     [2/5]  proposal → design → specs → tasks → plan（每步审查）
/alloy:apply    [3/5]  worktree 隔离 → TDD 实现 → 双层验证 → 复盘
/alloy:archive  [4/5]  Delta Spec 合并 → 移入 archive/
/alloy:finish   [5/5]  merge / PR / keep（人工闸门）

任意阶段退出，回来随便打哪个命令都能自动接上。

安装

npm install -g @flyin-ai/alloy
cd your-project
alloy init

alloy init 交互式完成环境检测、选择 AI Agent、部署命令和 schema。支持 Claude Code、Cursor、OpenCode 等 8 个平台。

命令速查

Slash Command（Agent 内使用）

| 命令 | 用途 | |------|------| | /alloy:start [topic] | 智能入口：状态检测 → 需求设计 | | /alloy:plan [name] | 规划：proposal → design → specs → tasks → plan | | /alloy:apply [name] | 执行：worktree + 实现 + 验证 + 复盘 | | /alloy:archive [name] | 归档：Delta Spec 合并 + 提交 | | /alloy:finish [name] | 收尾：merge / PR / keep | | /alloy:fix | Bug 修复：诊断 → 分流 | | /alloy:discard [name] | 放弃 change，清理现场 | | /alloy:status [name] | 查看阶段、制品、下一步 |

CLI 命令（终端使用）

| 命令 | 用途 | |------|------| | alloy init [path] | 项目初始化 | | alloy status [path] | 活跃 change 总览（支持 --json） | | alloy doctor [path] | 诊断：版本兼容、文件一致性（支持 --json） | | alloy update [path] | 更新命令和 schema 到最新版 |

文档导航

| 我想… | 读这个 | |-------|------| | 快速了解 Alloy | 可视化介绍 — 幻灯片 | | 快速上手使用 | handbook.md | | 看完整产品规格 | specification/01-product-spec.md | | 写或改 Alloy Skill | reference/skill-writing-guide.md | | 理解设计背景 | background/ — 起源 / 工具对比 / 流程推导 |

依赖

OpenSpec · Superpowers · Node.js ≥ 18 · git

许可

MIT