szse-speccoding

v0.2.1

Published

5 months ago

speccoding — OpenSpec + Superpowers 双星开发流程编排器。状态机驱动、阶段守卫强制校验、产物可追溯的 AI 辅助开发工作流。

0High
0Medium
0Low

yanfei11

openspec superpowers codebuddy workflow ai-development spec-driven

SpecCoding

OpenSpec + Superpowers 双星开发流程编排器

SpecCoding 是一个有状态的 AI 辅助开发编排器，在 OpenSpec（规格层） 和 Superpowers（能力层） 之上，引入显式状态机、阶段守卫（guard）、可追溯交接包（handoff）等工程化约束。

          SpecCoding (编排器)
    ═══════════════════════════
           │ 状态机驱动
           │ guard 强制校验
           │ 产物可追溯
           │
    ┌──────┴──────┐
    │  OpenSpec    │  ← 规格层：proposal → specs → design → tasks
    │  Superpowers │  ← 能力层：brainstorming → plan → implement → verify
    └──────────────┘

安装

npx szse-speccoding init

安装完成后，SpecCoding 的 skills 和脚本会部署到项目的 .codebuddy/skills/ 目录下。

前置依赖

openspec CLI：npm install -g @fission-ai/openspec
Superpowers 技能库：通过 CodeBuddy Code 的 skills-lock.json 配置，源为 https://gitee.com/shanyong-sy/superpowers.git

快速开始

安装 openspec CLI：npm install -g @fission-ai/openspec
初始化 OpenSpec：openspec init
安装 SpecCoding：npx szse-speccoding init
在 CodeBuddy Code 中运行：/comet

SpecCoding 会自动检测当前项目的 OpenSpec 状态，引导你通过完整的五阶段流程：开启 → 深度设计 → 计划与构建 → 验证与收尾 → 归档。

五阶段流程

| 阶段 | 命令 | 职责 | |------|------|------| | 1. 开启 | /comet-open | OpenSpec 探索，创建 change 结构（proposal + specs + design + tasks） | | 2. 深度设计 | /comet-design | Brainstorming，产出 Design Doc 和 delta spec | | 3. 计划与构建 | /comet-build | 制定实施计划，选择执行方式（subagent/direct），编码实现 | | 4. 验证与收尾 | /comet-verify | 规格实现一致性验证，分支处理 | | 5. 归档 | /comet-archive | Delta spec 同步到主 spec，change 归档 |

预设路径

/comet-hotfix — Bug 修复，跳过 brainstorming
/comet-tweak — 小改动（文案、配置、文档），跳过 brainstorming 和完整 plan

CLI 使用

npx szse-speccoding init                    # 安装到当前目录
npx szse-speccoding init --path /my-project  # 安装到指定项目
npx szse-speccoding init --force             # 强制覆盖已有文件

架构

关键机制

| 机制 | 说明 | |------|------| | 状态机 | .comet.yaml 记录 phase/isolation/build_mode 等，流程可中断恢复 | | 阶段守卫 (guard) | 每个阶段出口的 bash 脚本，校验退出条件 | | 交接包 (handoff) | OpenSpec→Superpowers 的上下文传递（JSON + MD），hash 可追溯 | | Spec 强制 | guard 检查 delta 头/MUST/SHALL/Scenario/WHEN/THEN | | 归档同步 | 归档时自动 merge delta spec 到主 spec（unified diff 预览） |

核心原则

OpenSpec 是事实源 — Superpowers 不修改 spec，通过 handoff 交接
Guard 是硬约束 — 每阶段出口强制执行，不通过就不能流转
状态可恢复 — .comet.yaml + --recover 脚本支持断点续跑
产物可追溯 — handoff hash、plan base-ref、Design Doc comet_change 构成可追溯链
用户始终在决策节点 — 设计确认、执行方式、分支处理都是阻塞点

许可证

MIT

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme