@lininn/openflow 0.1.9 → 0.2.0

package/README.md

@@ -65,6 +65,7 @@ Re-generates project skills after upgrading the npm package.
 | `/openflow proposal` | proposal | Lightweight capture — 3-5 questions to converge on requirements |
 | `/openflow brainstorming` | brainstorming | Deep design — multi-round tradeoff exploration |
 | `/openflow spec` | spec | Call OpenSpec to generate specs + auto-translate to plan-ready.md |
+| `/openflow amend` | amend | Revise requirements/specs before close and update plan-ready.md |
 | `/openflow build` | build | Call Superpowers to execute implementation |
 | `/openflow close` | close | Verify consistency + archive |
 
@@ -117,6 +118,12 @@ User Requirements
                           └──────────┬───────────┘
                                      │
                           ┌──────────▼───────────┐
+                          │  /openflow amend       │
+                          │  Requirement revision  │
+                          │  (only when needed)    │
+                          └──────────┬───────────┘
+                                     │
+                          ┌──────────▼───────────┐
                           │  /openflow close       │
                           │  Verify + archive      │
                           └──────────────────────┘

package/README.zh-CN.md

@@ -65,6 +65,7 @@ openflow update
 | `/openflow proposal` | proposal | 轻量提问，3-5 问快速收敛需求 |
 | `/openflow brainstorming` | brainstorming | 深度设计，多轮方案探索 |
 | `/openflow spec` | spec | 调用 OpenSpec 生成规格 + 自动翻译 |
+| `/openflow amend` | amend | close 前修订需求/规格并更新 plan-ready.md |
 | `/openflow build` | build | 调用 Superpowers 执行实现 |
 | `/openflow close` | close | 验证一致性 + 归档 |
 
@@ -117,6 +118,12 @@ Works without them: yes, with manual-file fallback
                           └──────────┬───────────┘
                                      │
                           ┌──────────▼───────────┐
+                          │  /openflow amend      │
+                          │  需求变更修订          │
+                          │  （仅需要时）           │
+                          └──────────┬───────────┘
+                                     │
+                          ┌──────────▼───────────┐
                           │  /openflow close       │
                           │  验证一致性 + 归档      │
                           └──────────────────────┘

package/dist/cli/init.js

@@ -108,6 +108,7 @@ export const initCommand = new Command('init')
     logger.info('  /openflow proposal      Quick requirement capture');
     logger.info('  /openflow brainstorming  Deep design exploration');
     logger.info('  /openflow spec           Generate specs + translate');
+    logger.info('  /openflow amend          Revise requirements before close');
     logger.info('  /openflow build          Execute implementation');
     logger.info('  /openflow close          Verify + archive');
     logger.blank();

package/dist/cli/status.js

@@ -64,7 +64,7 @@ export const statusCommand = new Command('status')
         const hasProposal = fs.existsSync(path.join(changeDir, 'proposal.md'));
         let status = '';
         if (hasPlanReady) {
-            status = '→ ready for /openflow build';
+            status = '→ ready for /openflow build or /openflow amend';
         }
         else if (hasProposal) {
             status = '→ needs /openflow spec';

package/dist/core/skill-generator.js

@@ -29,7 +29,7 @@ export function generateSkills(options) {
         // Generate main SKILL.md
         generateSkillFile(skillsDir, 'SKILL.md', depStatus);
         // Generate phase files
-        const phases = ['proposal', 'brainstorming', 'spec', 'build', 'close'];
+        const phases = ['proposal', 'brainstorming', 'spec', 'amend', 'build', 'close'];
         for (const phase of phases) {
             generateSkillFile(skillsDir, `${phase}.md`, depStatus);
         }
@@ -100,7 +100,7 @@ function getInlineTemplate(filename, depStatus) {
     const templates = {
         'SKILL.md': `---
 name: openflow
-description: "OpenSpec + Superpowers 工作流协调器。使用 /openflow proposal 轻量提问、/openflow brainstorming 深度设计、/openflow spec 生成规格、/openflow build 执行实现、/openflow close 验证归档。串联需求规格与工程执行，消除格式鸿沟。"
+description: "OpenSpec + Superpowers 工作流协调器。使用 /openflow proposal 轻量提问、/openflow brainstorming 深度设计、/openflow spec 生成规格、/openflow amend 在归档前修订需求、/openflow build 执行实现、/openflow close 验证归档。串联需求规格与工程执行，消除格式鸿沟。"
 ---
 
 # openflow - 工作流协调器
@@ -112,9 +112,10 @@ description: "OpenSpec + Superpowers 工作流协调器。使用 /openflow propo
 如果本轮没有显式 \`/openflow ...\` 子命令，但上一轮已经进入 openflow 任一阶段，并且用户是在补充范围、回答确认问题、说“继续”、修正需求、或说明新增/移除边界：
 
 1. 默认继续上一 openflow 阶段，不把该回复当作普通编码请求
-2. 如果上一阶段是 proposal、brainstorming 或 spec，只能继续产出/更新 OpenSpec 文档，不得修改任何代码或实现文件
-3. 只有用户显式调用 \`/openflow build\`，或状态检测明确进入 build 阶段后，才允许修改代码或实现文件
-4. 中断后恢复时，先重新读取当前阶段文件和 \`openspec/changes/\` 状态，再继续执行
+2. 如果上一阶段是 proposal、brainstorming、spec 或 amend，只能继续产出/更新 OpenSpec 文档和计划文档，不得修改任何代码或实现文件
+3. 如果上一阶段是 build，但用户补充的是需求、验收条件或规格边界变更，切到 \`/openflow amend\`，不要直接改代码
+4. 只有用户显式调用 \`/openflow build\`，或状态检测明确进入 build 阶段后，才允许修改代码或实现文件
+5. 中断后恢复时，先重新读取当前阶段文件和 \`openspec/changes/\` 状态，再继续执行
 
 典型场景：
 - proposal 阶段整理需求后，用户补充“运营端也要做回显”。这仍是需求范围修正，必须继续 proposal 文档收敛，不能直接进入代码实现。
@@ -127,10 +128,11 @@ description: "OpenSpec + Superpowers 工作流协调器。使用 /openflow propo
 | proposal | \`openspec/changes/**/proposal.md\` | 任何代码或实现文件 |
 | brainstorming | \`openspec/changes/**/proposal.md\` | 任何代码或实现文件 |
 | spec | \`openspec/changes/**\`、\`plan-ready.md\` | 任何代码或实现文件 |
+| amend | \`openspec/changes/**\`、\`plan-ready.md\`、\`docs/superpowers/plans/*.md\` | 代码、测试、其他实现文件 |
 | build | 代码、测试、实现计划状态 | 规格文档（除非另开变更） |
 | close | 归档、验证记录、\`close-issues.md\` | 代码、测试、其他实现文件 |
 
-如果用户在 proposal/brainstorming/spec 阶段提出“就按这个做”“范围改成 X”“继续”等话术，不代表进入 build；必须先完成该阶段文档产物并提示下一步。
+如果用户在 proposal/brainstorming/spec/amend 阶段提出“就按这个做”“范围改成 X”“继续”等话术，不代表进入 build；必须先完成该阶段文档产物并提示下一步。
 
 ## 子命令
 
@@ -139,6 +141,7 @@ description: "OpenSpec + Superpowers 工作流协调器。使用 /openflow propo
 | \`/openflow proposal\` | proposal | 轻量提问，快速收敛需求 |
 | \`/openflow brainstorming\` | brainstorming | 深度设计，多轮探索 |
 | \`/openflow spec\` | spec | 调用 OpenSpec 生成规格 + 翻译 |
+| \`/openflow amend\` | amend | build/close 前受控修改需求、规格和计划 |
 | \`/openflow build\` | build | 调用 Superpowers 执行实现 |
 | \`/openflow close\` | close | 验证一致性 + 归档 |
 
@@ -165,10 +168,11 @@ description: "OpenSpec + Superpowers 工作流协调器。使用 /openflow propo
 根据子命令或状态检测结果，读取对应阶段文件并执行：
 
 1. 如果这是上一 openflow 阶段的续接回复，先按“续接与中断恢复”保持阶段
-2. 如果用户指定了子命令（如 \`/openflow build\`），优先按指定阶段执行，但检查前置条件
-3. 如果用户只输入 \`/openflow\`，执行状态检测，自动路由到对应阶段
-4. 读取当前 openflow skill 目录下的阶段文件：\`<阶段>.md\`（与本 \`SKILL.md\` 同目录；不要依赖 Claude 专属环境变量）
-5. 按阶段文件中的流程执行，并遵守阶段写入边界
+2. 如果用户在 build 中明确提出需求变更、补充 spec、修改验收条件或重新生成规格，路由到 amend
+3. 如果用户指定了子命令（如 \`/openflow build\`），优先按指定阶段执行，但检查前置条件
+4. 如果用户只输入 \`/openflow\`，执行状态检测，自动路由到对应阶段
+5. 读取当前 openflow skill 目录下的阶段文件：\`<阶段>.md\`（与本 \`SKILL.md\` 同目录；不要依赖 Claude 专属环境变量）
+6. 按阶段文件中的流程执行，并遵守阶段写入边界
 
 ### 前置条件检查
 
@@ -177,6 +181,7 @@ description: "OpenSpec + Superpowers 工作流协调器。使用 /openflow propo
 | proposal | 无 | — |
 | brainstorming | 无 | — |
 | spec | 需要有活跃变更目录或有用户需求 | "请先用 /openflow proposal 或 /openflow brainstorming 描述需求" |
+| amend | 需要有活跃变更目录，通常需要 plan-ready.md | "还没有可修订的活跃变更，请先完成 /openflow spec" |
 | build | 需要存在 plan-ready.md | "请先完成 /openflow spec 生成规格和翻译" |
 | close | 需要实现已完成 | "实现尚未完成，请先用 /openflow build 执行" |
 `,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lininn/openflow",
-  "version": "0.1.9",
+  "version": "0.2.0",
   "description": "OpenSpec + Superpowers workflow orchestrator for Claude Code",
   "bin": {
     "openflow": "./bin/openflow.js"

package/templates/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: openflow
-description: "OpenSpec + Superpowers workflow orchestrator. Use /openflow proposal for quick capture, /openflow brainstorming for deep design, /openflow spec to generate specs + translate, /openflow build to execute, /openflow close to verify and archive. Bridges requirements specs and engineering execution."
+description: "OpenSpec + Superpowers workflow orchestrator. Use /openflow proposal for quick capture, /openflow brainstorming for deep design, /openflow spec to generate specs + translate, /openflow amend to revise requirements before close, /openflow build to execute, /openflow close to verify and archive. Bridges requirements specs and engineering execution."
 ---
 
 # openflow - 工作流协调器
@@ -12,9 +12,10 @@ description: "OpenSpec + Superpowers workflow orchestrator. Use /openflow propos
 如果本轮没有显式 `/openflow ...` 子命令，但上一轮已经进入 openflow 任一阶段，并且用户是在补充范围、回答确认问题、说“继续”、修正需求、或说明新增/移除边界：
 
 1. 默认继续上一 openflow 阶段，不把该回复当作普通编码请求
-2. 如果上一阶段是 proposal、brainstorming 或 spec，只能继续产出/更新 OpenSpec 文档，不得修改任何代码或实现文件
-3. 只有用户显式调用 `/openflow build`，或状态检测明确进入 build 阶段后，才允许修改代码或实现文件
-4. 中断后恢复时，先重新读取当前阶段文件和 `openspec/changes/` 状态，再继续执行
+2. 如果上一阶段是 proposal、brainstorming、spec 或 amend，只能继续产出/更新 OpenSpec 文档和计划文档，不得修改任何代码或实现文件
+3. 如果上一阶段是 build，但用户补充的是需求、验收条件或规格边界变更，切到 `/openflow amend`，不要直接改代码
+4. 只有用户显式调用 `/openflow build`，或状态检测明确进入 build 阶段后，才允许修改代码或实现文件
+5. 中断后恢复时，先重新读取当前阶段文件和 `openspec/changes/` 状态，再继续执行
 
 典型场景：
 - proposal 阶段整理需求后，用户补充“运营端也要做回显”。这仍是需求范围修正，必须继续 proposal 文档收敛，不能直接进入代码实现。
@@ -27,10 +28,11 @@ description: "OpenSpec + Superpowers workflow orchestrator. Use /openflow propos
 | proposal | `openspec/changes/**/proposal.md` | 任何代码或实现文件 |
 | brainstorming | `openspec/changes/**/proposal.md` | 任何代码或实现文件 |
 | spec | `openspec/changes/**`、`plan-ready.md` | 任何代码或实现文件 |
+| amend | `openspec/changes/**`、`plan-ready.md`、`docs/superpowers/plans/*.md` | 代码、测试、其他实现文件 |
 | build | 代码、测试、实现计划状态 | 规格文档（除非另开变更） |
 | close | 归档、验证记录、`close-issues.md` | 代码、测试、其他实现文件 |
 
-如果用户在 proposal/brainstorming/spec 阶段提出“就按这个做”“范围改成 X”“继续”等话术，不代表进入 build；必须先完成该阶段文档产物并提示下一步。
+如果用户在 proposal/brainstorming/spec/amend 阶段提出“就按这个做”“范围改成 X”“继续”等话术，不代表进入 build；必须先完成该阶段文档产物并提示下一步。
 
 ## 子命令
 
@@ -39,6 +41,7 @@ description: "OpenSpec + Superpowers workflow orchestrator. Use /openflow propos
 | `/openflow proposal` | proposal | 轻量提问，快速收敛需求 |
 | `/openflow brainstorming` | brainstorming | 深度设计，多轮探索 |
 | `/openflow spec` | spec | 调用 OpenSpec 生成规格 + 翻译 |
+| `/openflow amend` | amend | build/close 前受控修改需求、规格和计划 |
 | `/openflow build` | build | 调用 Superpowers 执行实现 |
 | `/openflow close` | close | 验证一致性 + 归档 |
 
@@ -65,10 +68,11 @@ description: "OpenSpec + Superpowers workflow orchestrator. Use /openflow propos
 根据子命令或状态检测结果，读取对应阶段文件并执行：
 
 1. 如果这是上一 openflow 阶段的续接回复，先按“续接与中断恢复”保持阶段
-2. 如果用户指定了子命令（如 `/openflow build`），优先按指定阶段执行，但检查前置条件
-3. 如果用户只输入 `/openflow`，执行状态检测，自动路由到对应阶段
-4. 读取当前 openflow skill 目录下的阶段文件：`<阶段>.md`（与本 `SKILL.md` 同目录；不要依赖 Claude 专属环境变量）
-5. 按阶段文件中的流程执行，并遵守阶段写入边界
+2. 如果用户在 build 中明确提出需求变更、补充 spec、修改验收条件或重新生成规格，路由到 amend
+3. 如果用户指定了子命令（如 `/openflow build`），优先按指定阶段执行，但检查前置条件
+4. 如果用户只输入 `/openflow`，执行状态检测，自动路由到对应阶段
+5. 读取当前 openflow skill 目录下的阶段文件：`<阶段>.md`（与本 `SKILL.md` 同目录；不要依赖 Claude 专属环境变量）
+6. 按阶段文件中的流程执行，并遵守阶段写入边界
 
 ### 前置条件检查
 
@@ -77,5 +81,6 @@ description: "OpenSpec + Superpowers workflow orchestrator. Use /openflow propos
 | proposal | 无 | — |
 | brainstorming | 无 | — |
 | spec | 需要有活跃变更目录或有用户需求 | "请先用 /openflow proposal 或 /openflow brainstorming 描述需求" |
+| amend | 需要有活跃变更目录，通常需要 plan-ready.md | "还没有可修订的活跃变更，请先完成 /openflow spec" |
 | build | 需要存在 plan-ready.md | "请先完成 /openflow spec 生成规格和翻译" |
 | close | 需要实现已完成 | "实现尚未完成，请先用 /openflow build 执行" |

package/templates/amend.md

@@ -0,0 +1,136 @@
+---
+name: openflow/amend
+description: Revise active OpenSpec requirements during build, regenerate plan-ready.md, and append implementation tasks without archiving the change
+---
+
+# Amend: 需求变更修订
+
+## 目标
+
+在 active change 已经进入 spec/build 后，发现需求遗漏或规格需要改变时，受控修改 OpenSpec 文档和执行计划，然后回到 `/openflow build` 继续实现。
+
+## 适用场景
+
+- build 过程中发现原需求漏了一个功能、边界或验收条件
+- 用户明确说“修改需求”“补充 spec”“重新生成规格”“需求变更”
+- close 前发现规格本身不完整，而不是代码没有按现有规格实现
+
+不适用：
+- 只是代码没有实现现有 spec → 继续 `/openflow build`
+- 变更已经 close/archive → 开新的 `/openflow proposal` 或 `/openflow brainstorming`
+- 只是文案、注释或实现细节调整，且不改变行为 → 继续当前实现阶段
+
+## 前置条件
+
+- `openspec/changes/<变更名>/` 下存在 active change
+- 至少存在 `proposal.md`
+- 通常应已存在 `plan-ready.md`；如果没有，优先回到 `/openflow spec`
+
+如果没有 active change，提示：
+> "还没有活跃变更。请先用 /openflow proposal 或 /openflow brainstorming 创建需求。"
+
+如果变更已归档，提示：
+> "该变更已经归档。归档后的需求调整应开启新的 /openflow proposal。"
+
+## 流程
+
+### 1. 确认当前变更
+
+检查 `openspec/changes/` 下的 active change。
+
+如果有多个，列出并让用户选择：
+> "检测到多个活跃变更：[列表]。要修订哪个变更？"
+
+读取当前变更的文档：
+- `proposal.md`
+- `design.md`（如果存在）
+- `specs/**/spec.md`
+- `tasks.md`（如果存在）
+- `plan-ready.md`（如果存在）
+- `docs/superpowers/plans/` 下对应实现计划（如果存在）
+
+### 2. 判断是 amend 还是 build
+
+先判断用户描述属于哪类：
+
+| 情况 | 处理 |
+|------|------|
+| 现有 spec 已覆盖，只是代码未完成 | 回到 `/openflow build` |
+| 新增/修改行为、验收条件、边界、非目标 | 继续 amend |
+| 技术方案受影响 | 修改 `design.md` 并追加任务 |
+| 不确定是否改变需求 | 问 1 个澄清问题 |
+
+### 3. 修改 OpenSpec 文档
+
+按影响范围更新：
+
+- `proposal.md`：追加 `## Amendments`，记录本次需求变更的日期、原因和摘要
+- `design.md`：仅当技术方案或约束变化时修改
+- `specs/<capability>/spec.md`：使用 `ADDED`、`MODIFIED`、`REMOVED` 或 `RENAMED Requirements` 表达 delta
+- `tasks.md`：追加新任务；不要重写或删除已完成任务
+
+要求：
+- 每个新增或修改的 requirement 必须至少有一个 `#### Scenario:`
+- `MODIFIED Requirements` 必须包含完整的新 requirement 文本，不只写差异片段
+- 已完成任务保留原 checkbox 状态
+
+### 4. 校验 OpenSpec
+
+如果 OpenSpec CLI 可用，运行：
+
+```bash
+openspec validate <变更名> --strict
+```
+
+校验失败时，修正文档后重新校验。
+
+### 5. 重新生成 plan-ready.md
+
+根据修订后的 OpenSpec 文档更新 `plan-ready.md`。
+
+规则：
+- 保留原 `## 来源`
+- 追加 `## Amendments`，记录本次修订来源和影响
+- 保留已完成实现步骤的历史上下文
+- 追加新的实现步骤，按执行依赖排序
+- 不删除已经完成或正在执行的步骤，除非用户明确要求废弃并说明迁移方式
+
+建议追加格式：
+
+```markdown
+## Amendments
+
+### YYYY-MM-DD: <简短标题>
+- 原因：<为什么需要改>
+- 影响规格：<spec 路径>
+- 影响任务：<tasks.md 条目>
+
+## 追加实现步骤
+
+### Task N: <任务名>
+- 目标：<做什么>
+- 改动文件：<哪些文件>
+- 验证方式：<怎么验证>
+```
+
+### 6. 同步详细实现计划
+
+如果 `docs/superpowers/plans/YYYY-MM-DD-<变更名>.md` 已存在：
+- 已勾选任务不动
+- 未完成任务可按新需求调整
+- 追加新 task，保留 checkbox
+- 记录本次 amend 来源路径
+
+如果详细实现计划还不存在：
+- 不创建代码实现计划，提示下一步用 `/openflow build`
+
+### 7. 提示下一步
+
+> "需求变更已写入 OpenSpec，plan-ready.md 已更新。接下来继续 `/openflow build`。"
+
+## 关键原则
+
+- amend 阶段只允许修改规格、任务、plan-ready.md 和实现计划文档，不直接修改代码
+- amend 是 close/archive 前的受控需求变更入口，不用于修代码
+- 不把 build 中的自然语言补充直接当作实现指令；只要改变需求或验收条件，先 amend
+- 已归档变更不可 amend，必须开启新 change

package/templates/build.md

@@ -11,7 +11,9 @@ description: Call Superpowers to execute implementation, supports checkpoint rec
 
 ## 中断续接规则
 
-如果用户在 build 阶段被打断后继续回复、说“继续”、或补充实现细节，保持 build 阶段并从实现计划/checkbox 状态恢复。不要回到 proposal、brainstorming 或 spec，除非用户明确要求修改需求或重新生成规格。
+如果用户在 build 阶段被打断后继续回复、说“继续”、或补充实现细节，保持 build 阶段并从实现计划/checkbox 状态恢复。不要回到 proposal、brainstorming 或 spec。
+
+如果用户明确要求修改需求、补充 spec、改变验收条件、改变功能边界或重新生成规格，停止实现并切到 `/openflow amend`。amend 完成后再回到 `/openflow build`。
 
 ## 前置条件
 
@@ -73,7 +75,7 @@ docs/superpowers/plans/YYYY-MM-DD-<变更名>.md
 
 ## 关键原则
 
-- **不允许在 build 阶段修改规格文档** — 发现问题先记录，留到 close 阶段处理
+- **不允许在 build 阶段修改规格文档** — 发现需求遗漏或规格错误时切到 `/openflow amend`
 - build 是唯一默认允许修改代码或实现文件的阶段；如果上一阶段不是 build，不要因为用户确认范围而自动写代码
 - plan-ready.md 是锁定的设计决策，Superpowers 按计划展开执行，不重新理解需求
 - 断点恢复依赖文件系统状态，不依赖 AI 的会话记忆