把目标讨论清楚
/g-spec先读现状,澄清目标、范围与非目标,再拷问承重前提。方案确定后生成四件套与决策纪要。
MEMO + SPEC + DESIGN把需求、设计、实现和验证,
连成一条可以中断、恢复、追溯的开发路径。
一套服务于 AI 辅助开发的规格驱动工作流。你决定目标与关键取舍,AI 串行推进,脚本守住可确定的边界。
# 一个明确的目标,一条可恢复的路径
/g-spec先核对真实代码,再澄清目标与关键前提。
点击切换阶段 · 展示职责与产物,不执行真实命令
01 / THE WORKFLOW
不是让你记住更多命令。
把关键判断留下来,让后续执行有据可依。
/g-spec先读现状,澄清目标、范围与非目标,再拷问承重前提。方案确定后生成四件套与决策纪要。
MEMO + SPEC + DESIGN/g-review spec从完整性、可行性、领域、对抗和真实代码逐一检查。报告交给你,明确批准后才进入实施。
用户明确批准/g-implement按依赖逐票串行实现。每票经过需求轴与规范轴自审,执行验收,再提交完成标签。
TICKETS + EVIDENCE/g-review code核对范围、边界、错误路径和历史问题。P0/P1 未解决就阻塞,只有不影响验收的 P2 可以延期。
REVIEW + REAL ISSUES/g-done <change>逐需求核对实现与测试证据,保留详细交接说明,同步规格并归档。默认留在工作分支,不合并。
VERIFY + HAND-OFF源码在检查后发生变化,写锚就会拒绝。报告提交限定路径,避免夹带未经验证的源码。
完成状态读取已提交的 checkpoint 标签;零用例、缺证据、环境故障都不能被包装成真实通过。
每个 change 保存固定起始 SHA 与工作分支。默认不合并;只有你明确指定目标,才执行合并。
内联多视角共享一个上下文。gate 能校验结构与内容关系,不能证明语义判断无误,也不能代替真实测试。
03 / THE TOOLKIT
主流程负责一次交付。
规划、环境、记录与复盘,按项目需要加入。
把澄清、拷问和生成放在同一条路径上,先确认承重前提,再形成正式变更材料。
串行检查范围、领域、对抗与接地事实。区分结构通过、内容判断和用户批准。
出票与执行分开。以纵向切片交付行为,按 Blocked-by 串行选票,逐票保存验收证据。
每步读取 gate,从当前盘面继续实现、评审、验证、交接和归档。默认不合并、不 push。
采集事实、划分子系统、定义 contract,检查场景覆盖,形成可进入骨架实施的 SAD。
把超过一个 change 的工作拆成分阶段交付。近期细化,远期保留边界与依赖。
查明单元、集成与 e2e 怎么跑,写出每层信心与盲区,记录真实泳道状态与证据。
铺设项目骨架、schema 和人读手册,注入托管入口,保留项目自定义内容。
按实际运行 checkout 的远程执行 ff-only 更新,再刷新安装,避免指令与脚本版本错位。
bug 与 todo 分池。一个问题一个文件,记录来源、状态与证据,复用历史 ID。
新建决策、按变更同步、分批体检已有 ADR。格式交给脚本,内容事实依靠读码核对。
从已有 Git 与报告再生阶段耗时和历史统计。只呈现已有证据,不自动调整流程。
04 / A DELIVERY YOU CAN READ
完整流程结束后,hand-off.md 随变更一起归档。下次接手时,你能知道做了什么、为什么这样做,以及还有什么没有完成。
hand-off.md随 change 归档05 / GET STARTED
终端安装一次工具链,给目标项目接入流程。
之后,每次变更从一个清晰的需求开始。
需要 Git、Bash、Python 3、OpenSpec CLI 和 mikefarah/yq。GitHub 仓库访问需要对应权限。
在你的业务项目中初始化 OpenSpec,再调用 /g-init。补充真实技术栈、约束和测试命令。
用 /g-spec 讨论需求,设计审后明确批准,再交给 /g-done 连续推进。
git clone https://github.com/Alexwhitee/gearbox.git \
"$HOME/.skills/g-skills"
cd "$HOME/.skills/g-skills"
bash setup.sh# 为项目启用工作流
/g-init
# 讨论并生成本次需求
/g-spec
# 设计评审 → 你明确批准
/g-review spec
# 替换成真实的 change 名
/g-done your-change-name斜杠命令在 AI 会话中使用,不是终端命令。也可以明确说“使用 g-spec”。
/g-init → /g-architecture → /g-devenv → /g-spec先明确系统边界与测试路径。确实跨多个变更时,再用 /g-roadmap 拆阶段。
06 / THINGS WORTH KNOWING
不会默认合并,也不会自动 push。无论从 a 新建功能分支,还是直接在 a 开发,默认都是提交、验证、归档后留在工作分支。只有你明确指定合并目标,才会尝试 ff-only 合并。
不需要。对同一个 change 重新运行 /g-done,执行者会读取 gate、报告、固定基准和提交记录,定位需要补做的步骤。已写代码但缺验收或完成标签的票,会先核对已有实现,再补齐验证。
不是。当前是一个主会话逐视角检查,不调用子代理,不跨模型调度,也不配置模型档位。不同视角有各自的清单,但共享上下文,不能宣称提供了独立第二意见。
可以,但必须如实说明覆盖边界。未配置命令不等于没有测试:执行者先查 CI、README 和既有约定。确实没有某一层才记录依据;有明确测试域且配置无自动层时,也要保留起始版本与需求验收证据。
范围、偏好和关键取舍最终属于你。主变更链保留设计批准点,AI 准备推荐、依据、代价与备选;明确批准后才记录设计门。报告写着通过或者你没有反对,都不能替代明确批准。
不用。日常主线是 /g-init、/g-spec、/g-review spec 和 /g-done。出票、逐票实现与代码审通常由 done 按 gate 调用;其余入口在需要规划、环境、记录或复盘时使用。
LESS GUESSWORK. MORE TRACEABILITY.
保留关键判断,执行真实验证。
让代码、证据和交接,一起抵达终点。