Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
{
"name": "spec-superflow",
"description": "8-state workflow engine with 9 collaborative skills. Bridges planning and execution via execution-contract.md. Embedded schema validation, TDD, SDD, code review, systematic debugging, and delta spec sync.",
"version": "0.10.0",
"version": "0.11.0",
"source": "./",
"author": {
"name": "MageByte",
Expand Down
2 changes: 1 addition & 1 deletion .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "spec-superflow",
"version": "0.10.0",
"version": "0.11.0",
"description": "Spec-first workflow: integrates OpenSpec planning engine + Superpowers execution discipline. 9 collaborative skills with embedded TDD, SDD, code review, debugging, and delta spec sync.",
"source": "./",
"author": {
Expand Down
2 changes: 1 addition & 1 deletion .claude/always/phase-guard.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
# spec-superflow v0.10.0 | 阶段: {{state}} | 工作流: {{workflow}}
# spec-superflow v0.11.0 | 阶段: {{state}} | 工作流: {{workflow}}
当前阶段允许的操作由 workflow-start 路由规则定义。
禁止跨越 DP gate 进入下一阶段。变更范围以 execution-contract.md 的 Intent Lock 为准。
2 changes: 1 addition & 1 deletion .codex-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "spec-superflow",
"version": "0.10.0",
"version": "0.11.0",
"description": "Spec-first workflow that bridges OpenSpec-style planning and Superpowers-style execution discipline.",
"author": {
"name": "MageByte",
Expand Down
2 changes: 1 addition & 1 deletion .cursor-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
},
"metadata": {
"description": "Spec-first workflow plugin marketplace for Cursor",
"version": "0.10.0"
"version": "0.11.0"
},
"plugins": [
{
Expand Down
2 changes: 1 addition & 1 deletion .cursor-plugin/plugin.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"name": "spec-superflow",
"displayName": "spec-superflow",
"description": "Spec-first workflow: integrates OpenSpec planning engine + Superpowers execution discipline. 9 collaborative skills with embedded TDD, SDD, code review, debugging, and delta spec sync.",
"version": "0.10.0",
"version": "0.11.0",
"author": {
"name": "MageByte",
"url": "https://github.com/MageByte-Zero"
Expand Down
4 changes: 2 additions & 2 deletions .github/plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -6,13 +6,13 @@
},
"metadata": {
"description": "Spec-first workflow plugins and skills for AI coding agents.",
"version": "0.10.0"
"version": "0.11.0"
},
"plugins": [
{
"name": "spec-superflow",
"description": "Spec-first workflow with planning artifacts, execution contracts, TDD, review gates, systematic debugging, and delta spec sync.",
"version": "0.10.0",
"version": "0.11.0",
"source": ".",
"author": {
"name": "MageByte",
Expand Down
10 changes: 9 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,13 +6,21 @@ The format loosely follows Keep a Changelog.

## [Unreleased]

## [0.11.0] - 2026-07-21

### Added

- **Closes #47 — Recovery workflow commands**: publish `ssf resume`, `ssf switch`, and `ssf save` as a control-plane overlay. Resume/switch are read-only; save writes only the compatible checkpoint and never automatically commits, pushes, or syncs. WorkBuddy distributes the canonical `/ssf:resume`, `/ssf:switch`, and `/ssf:save` Markdown command adapters.
- **Closes #47 — Recovery workflow commands**: add `ssf resume`, `ssf switch`, and `ssf save` as a control-plane overlay. Resume/switch are read-only; save writes only the compatible checkpoint and never automatically commits, pushes, or syncs. WorkBuddy distributes the canonical `/ssf:resume`, `/ssf:switch`, and `/ssf:save` Markdown command adapters.
- **Closes #70 — Workflow path recommendation and selection**: `ssf workflow recommend/select/show` collects minimal intake facts, recommends full, hotfix, or tweak with reasons, and requires an explicit, auditable choice before workflow state routing continues.

### Changed

- **#65 — Planning artifact language inheritance**: proposal, specs, design, tasks, and execution contracts inherit the conversation language instead of defaulting to English.

### Fixed

- **#64 — closing 终态生命周期对齐**:将 `release-archivist` 验证、`spec-merger` 同步和归档确认明确为 `executing` 内的 pre-closing 收尾步骤;`closing` 是 `CLOSED` 成功终态,且没有 next skill。
- **#71 — Taskless hotfix closure**: hotfix changes without `tasks.md` can satisfy the closing guard after their minimal contract and required verification are complete.

## [0.10.0] - 2026-07-16

Expand Down
2 changes: 1 addition & 1 deletion GEMINI.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ The workflow is self-contained and does not require OpenSpec or Superpowers at r


<!-- spec-superflow-phase-guard-start -->
# spec-superflow v0.10.0 | 阶段: {{state}} | 工作流: {{workflow}}
# spec-superflow v0.11.0 | 阶段: {{state}} | 工作流: {{workflow}}
当前阶段允许的操作由 workflow-start 路由规则定义。
禁止跨越 DP gate 进入下一阶段。变更范围以 execution-contract.md 的 Intent Lock 为准。
<!-- spec-superflow-phase-guard-end -->
2 changes: 1 addition & 1 deletion INSTALL.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@
- [Fission-AI/OpenSpec](https://github.com/Fission-AI/OpenSpec) — 规划引擎(Schema 验证、Delta Spec、工件解析)
- [obra/superpowers](https://github.com/obra/superpowers) — 执行纪律(TDD 铁律、SDD、系统化调试、代码审查)

当前发布版本:**v0.10.0**。
当前发布版本:**v0.11.0**。

---

Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -166,7 +166,7 @@ npx spec-superflow list # 或通过 npx 使用

### 版本

- 当前版本:`v0.10.0`
- 当前版本:`v0.11.0`
- v0.9.1 highlights:DP-4 执行模式推荐、跨 17 个平台的 portable runtime,以及无插件根路径的 raw-package smoke;详见 [CHANGELOG.md](CHANGELOG.md)
- v0.9.0 highlights:支持 Node 20/22、model profiles 只读解析,以及 code-reviewer 的最小性审查
- 自包含插件,不需要运行时安装 OpenSpec 或 Superpowers
Expand Down
2 changes: 1 addition & 1 deletion commands/ssf/resume.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,6 @@ argument-hint: "[change-name-or-path]"
allowed-tools: Bash(npx:*)
---

先检查 `$ARGUMENTS` 是否为非空目标:为空时运行 `npx --yes --package spec-superflow@0.10.0 ssf resume --json`,让 CLI 按唯一活跃 change 的既有确定性规则选择;非空时运行 `npx --yes --package spec-superflow@0.10.0 ssf resume --json "$ARGUMENTS"`,将整个目标作为单一字面参数。
先检查 `$ARGUMENTS` 是否为非空目标:为空时运行 `npx --yes --package spec-superflow@0.11.0 ssf resume --json`,让 CLI 按唯一活跃 change 的既有确定性规则选择;非空时运行 `npx --yes --package spec-superflow@0.11.0 ssf resume --json "$ARGUMENTS"`,将整个目标作为单一字面参数。

只使用返回的 `change`、`blockers` 和 `next_action`:存在 blocker 时停止并展示修复命令;否则通过 `workflow-start` 进入 `next_action` 指定的下一 skill。不要直接修改状态文件。
2 changes: 1 addition & 1 deletion commands/ssf/save.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,4 +7,4 @@ allowed-tools: Bash(npx:*)

只把 `$ARGUMENTS` 作为对话输入,从中提取明确的 change、task 和 next,以及用户明确提供的可选 evidence 字段。信息不足时先询问一次;不要编造 verification 或 review 证据。

确认参数后运行 `npx --yes --package spec-superflow@0.10.0 ssf save "<change>" --task "<task-id>" --next "<next-step>" [--completed "<completed>"] [--verification "<verification>"] [--review "<review>"] [--risk "<risk>"] [--commit-start "<commit-start>"] [--commit-end "<commit-end>"] --json`。每个值必须来自已提取或已确认的信息,并作为单独引用的字面参数传入。只报告 CLI 返回的 checkpoint 结果,并保留现有状态机和存储边界。
确认参数后运行 `npx --yes --package spec-superflow@0.11.0 ssf save "<change>" --task "<task-id>" --next "<next-step>" [--completed "<completed>"] [--verification "<verification>"] [--review "<review>"] [--risk "<risk>"] [--commit-start "<commit-start>"] [--commit-end "<commit-end>"] --json`。每个值必须来自已提取或已确认的信息,并作为单独引用的字面参数传入。只报告 CLI 返回的 checkpoint 结果,并保留现有状态机和存储边界。
2 changes: 1 addition & 1 deletion commands/ssf/switch.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,4 +7,4 @@ allowed-tools: Bash(npx:*)

`$ARGUMENTS` 必须提供一个非空的 change 名称或路径;若未提供,先询问用户选择哪个 change。

确认目标非空后运行 `npx --yes --package spec-superflow@0.10.0 ssf switch --json "$ARGUMENTS"`,将整个目标作为单一字面参数。只使用返回的恢复上下文切换当前对话的关注对象。存在 blocker 时停止并展示修复命令;不得改变文件、工作目录或任何隐藏指针。
确认目标非空后运行 `npx --yes --package spec-superflow@0.11.0 ssf switch --json "$ARGUMENTS"`,将整个目标作为单一字面参数。只使用返回的恢复上下文切换当前对话的关注对象。存在 blocker 时停止并展示修复命令;不得改变文件、工作目录或任何隐藏指针。
2 changes: 1 addition & 1 deletion docs/README_en.md
Original file line number Diff line number Diff line change
Expand Up @@ -129,7 +129,7 @@ npm install -g spec-superflow

### Version

- Current: `v0.10.0`
- Current: `v0.11.0`
- v0.9.1 highlights: DP-4 execution-mode recommendations, a portable runtime across 17 platforms, and a raw-package smoke with no plugin-root variable.
- Self-contained — no OpenSpec or Superpowers runtime required
- Upstream: [Fission-AI/OpenSpec](https://github.com/Fission-AI/OpenSpec), [obra/superpowers](https://github.com/obra/superpowers)
Expand Down
12 changes: 7 additions & 5 deletions docs/decision-points.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,11 @@

- **编号**:DP-0
- **名称**:设计前确认
- **触发条件**:`workflow-start` 检测到规划工件不存在或不完整,准备路由到 `spec-writer` 之前
- **所需输入**:变更名称与意图、已知约束(命名风格、兼容性、受影响平台)、是否包含相关优化、用户沟通偏好
- **预期输出**:用户确认关键决策,或提出修改意见;`workflow-start` 将确认结果写入 `.spec-superflow.yaml` 的 `dp_0_*` 字段
- **触发条件**:`workflow-start` 检测到 change 目录不存在、规划工件不存在或不完整、`dp_0_confirmed` 尚未确认,或 legacy change 的 workflow 为 `auto`/空时;该门禁覆盖 full 以及直接进入 hotfix/tweak 的 fast paths,不只发生在路由到 `spec-writer` 之前
- **所需输入**:变更名称与意图、已知约束(命名风格、兼容性、受影响平台)、是否包含相关优化、用户沟通偏好;以及最少路径事实(任务数、文件数、是否仅配置/文档、是否涉及 schema/API、新模块和不确定性)
- **路径选择协议**:`workflow-start` 先读取 `ssf workflow show`;仅在 `missing_facts` 列出的字段缺失时提问,再运行 `ssf workflow recommend`。它必须向用户展示 Observed、Available、Recommended、Why 四项信息,推荐本身不改变状态也不写入 workflow。用户明确选择 `full`、`hotfix` 或 `tweak` 后,才可用 `ssf workflow select --confirm` 持久化;选择非推荐路径还必须显式传入 `--acknowledge-recommendation`。
- **确认顺序**:可先解析 `artifact_language`,随后必须完成路径 receipt 读取、最少事实补全、建议展示和用户选择;路径摘要与其他 DP-0 决定合并确认后,才可设置 `dp_0_confirmed=true`。
- **预期输出**:完整、防篡改的路径选择 receipt 固定保存在 change overlay 的 `.superpowers/sdd/workflow-selection.json`,用于恢复和审计;`.spec-superflow.yaml` 的 `dp_0_*` 只保存确认结果与幂等的 `workflow_path`/推荐对齐摘要,并保留既有 `scope` 和 `artifact_language`。空目录的 legacy artifact inference 可以返回 `full` 以兼容旧 API,但绝不能替代入口的用户选择。
- **关联 skill**:`spec-superflow:workflow-start`

## DP-1: 需求确认
Expand Down Expand Up @@ -43,8 +45,8 @@
- **编号**:DP-4
- **名称**:执行模式选择
- **触发条件**:build-executor 启动执行前,用户需要选择本次执行的开发模式
- **所需输入**:已批准的 `execution-contract.md`、项目测试基础设施现状、用户对 TDD(测试驱动开发)和 SDD(规格驱动开发)两种模式的说明
- **预期输出**:用户明确选择 TDD 模式或 SDD 模式,build-executor 据此调整执行策略
- **所需输入**:已批准的 `execution-contract.md`、项目测试基础设施现状,以及 `ssf execution recommend` 提供的执行模式证据与建议
- **预期输出**:用户明确选择 `Inline`、`Batch Inline` 或 `SDD` 执行模式,build-executor 据此创建受确认的执行计划。DP-4 不重新选择 DP-0 已确认的 `full`、`hotfix` 或 `tweak` 路径。
- **关联 skill**:`spec-superflow:build-executor`

## DP-5: 调试升级
Expand Down
Loading
Loading