cc-devflow 4.3.0 → 4.5.0

package/.claude/commands/flow/init.md

@@ -1,38 +0,0 @@
----
-name: flow-init
-description: 'Initialize requirement context via harness engine. Usage: /flow:init "REQ-123|Title|URLs?"'
-skill: workflow/flow-init
----
-
-# Flow-Init Command (Harness Entry)
-
-> 触发入口：执行细节由 `.claude/skills/workflow/flow-init/SKILL.md` 定义。
-
-## User Input
-
-```text
-$ARGUMENTS = "REQ_ID|TITLE|PLAN_URLS?"
-```
-
-## Usage
-
-```bash
-/flow:init "REQ-123|User Auth"
-/flow:init "REQ-124|订单导出|https://plan.example.com/req-124"
-```
-
-## Internal Execution
-
-1. `npm run harness:init -- --change-id <REQ_ID> --goal "Deliver <REQ_ID>: <TITLE>"`
-2. `npm run harness:pack -- --change-id <REQ_ID>`
-
-## Output
-
-- `devflow/requirements/<REQ_ID>/context-package.md`
-- `devflow/requirements/<REQ_ID>/harness-state.json`
-
-## Next Step
-
-```bash
-/flow:spec "<REQ_ID>"
-```

package/.claude/commands/flow/release.md

@@ -1,36 +0,0 @@
----
-name: flow-release
-description: 'Release requirement after verify pass. Usage: /flow:release "REQ-123" [--janitor-hours N]'
-skill: workflow/flow-release
----
-
-# Flow-Release Command (Harness Release)
-
-> 触发入口：执行细节由 `.claude/skills/workflow/flow-release/SKILL.md` 定义。
-
-## User Input
-
-```text
-$ARGUMENTS = "REQ_ID [--janitor-hours N]"
-```
-
-## Usage
-
-```bash
-/flow:release "REQ-123"
-/flow:release "REQ-123" --janitor-hours 72
-```
-
-## Internal Execution
-
-1. `npm run harness:release -- --change-id <REQ_ID>`
-2. `npm run harness:janitor -- --hours <N>` (default: `72`)
-
-## Output
-
-- `devflow/requirements/<REQ_ID>/RELEASE_NOTE.md`
-- `devflow/requirements/<REQ_ID>/harness-state.json` (`status: released`)
-
-## Completion
-
-- 主链闭环：`init → spec → dev → verify → release`

package/.claude/commands/flow/restart.md

@@ -1,97 +0,0 @@
----
-name: flow-restart
-description: 'Restart interrupted cc-devflow requirement development. Usage: /flow:restart "REQ-123" [--from=stage]'
-scripts:
-  prereq: .claude/scripts/check-prerequisites.sh
-  recover: .claude/scripts/recover-workflow.sh
-  generate_status: .claude/scripts/generate-status-report.sh
----
-
-# Flow-Restart - 中断恢复命令
-
-## User Input
-```text
-$ARGUMENTS = "REQ_ID [--from=stage] [--force] [--backup]"
-```
-
-## 支持阶段
-```
-init | spec | dev | verify | release
-```
-兼容别名：`research->init`、`prd/planning->spec`、`development->dev`、`qa/quality->verify`。
-
-## 执行流程
-
-### 阶段 1: Entry Gate
-```
-1. 参数解析
-   → 校验 REQ_ID（REQ-\d+）、阶段枚举。
-
-2. 状态自检
-   → Run: {SCRIPT:prereq} --json --paths-only
-   → 确认 devflow/requirements/${REQ_ID}/ 存在
-   → orchestration_status.json.status ∈ {failed, paused, *_failed}
-   → 若 status 已完成且未使用 --force → 拒绝重启。
-
-3. 中断点检测
-   → 调用 {SCRIPT:recover} --detect "${REQ_ID}"
-   → 解析中断原因、推荐恢复阶段、待恢复的产物。
-
-4. 备份（可选）
-   → 如果 --backup，则创建 `${REQ_DIR}/backup/${timestamp}` 目录复制关键文件。
-```
-
-### 阶段 2: 清理与重置
-```
-1. 根据阶段执行清理动作:
-   • init: 清理临时 research/mcp 缓存、保留 summary
-   • spec: 备份 PRD.md/EPIC.md/TASKS.md，重置 planning 状态
-   • dev: 检查未完成任务、生成 git stash 建议
-   • verify: 删除过期 TEST_REPORT/SECURITY_REPORT
-   • release: 关闭未完成 PR 草稿、重置 release 状态
-
-2. 更新 orchestration_status:
-   → status = "${stage}_restart_in_progress"
-   → restartStage = stage
-   → restartAt = timestamp
-
-3. EXECUTION_LOG.md 记录恢复动作和备份路径。
-```
-
-### 阶段 3: 恢复执行
-```
-1. 根据 stage 自动触发后续命令提示：
-   → init（兼容 research）→ `/flow:init "REQ_ID|TITLE|URLS?"`
-   → spec（兼容 prd/planning）→ `/flow:spec "REQ_ID"`
-   → dev（兼容 development）→ `/flow:dev "REQ_ID" --resume`
-   → verify（兼容 qa/quality）→ `/flow:verify "REQ_ID" --strict`
-   → release → `/flow:release "REQ_ID"`
-
-2. 若 {SCRIPT:recover} 支持自动修复（如重建 TASKS），执行对应脚本。
-```
-
-### 阶段 4: Exit Gate
-```
-1. 验证关键产物是否存在（与阶段相符）。
-2. orchestration_status:
-   → status = "${stage}_restart_ready"
-   → completedSteps 不剥夺已完成阶段
-3. 输出下一步指引。
-```
-
-## 错误处理
-- 检测不到中断 → 提示使用 `/flow:status` 查看当前状态，或需 --force。
-- 备份失败 → 终止并保留原样。
-- 清理动作报错 → 输出日志路径，允许用户手动处理后重试。
-
-## 输出
-```
-✅ backup/ 时间戳目录（若启用备份）
-✅ orchestration_status.json 更新（restartStage, restartAt, status）
-✅ EXECUTION_LOG.md 恢复条目
-```
-
-## 下一步
-1. 按提示执行下一阶段命令。
-2. 使用 `/flow:status REQ_ID --detailed` 确认状态恢复正确。
-3. 如多次失败，考虑跑 `/flow:verify` 或手动 review 产物。

package/.claude/commands/flow/spec.md

@@ -1,36 +0,0 @@
----
-name: flow-spec
-description: 'Generate task-manifest from requirement context. Usage: /flow:spec "REQ-123" [--overwrite]'
-skill: workflow/flow-spec
----
-
-# Flow-Spec Command (Harness Planning)
-
-> 触发入口：执行细节由 `.claude/skills/workflow/flow-spec/SKILL.md` 定义。
-
-## User Input
-
-```text
-$ARGUMENTS = "REQ_ID [--overwrite]"
-```
-
-## Usage
-
-```bash
-/flow:spec "REQ-123"
-/flow:spec "REQ-123" --overwrite
-```
-
-## Internal Execution
-
-- `npm run harness:plan -- --change-id <REQ_ID> [--overwrite]`
-
-## Output
-
-- `devflow/requirements/<REQ_ID>/task-manifest.json`
-
-## Next Step
-
-```bash
-/flow:dev "<REQ_ID>"
-```

package/.claude/commands/flow/status.md

@@ -1,64 +0,0 @@
----
-name: flow-status
-description: 'Query development progress status for cc-devflow requirements. Usage: /flow:status [REQ-ID]'
-scripts:
-  prereq: .claude/scripts/check-prerequisites.sh
-  generate_status: .claude/scripts/generate-status-report.sh
----
-
-# Flow-Status - 开发进度查询命令
-
-## User Input
-```text
-$ARGUMENTS = "[REQ_ID?] [--all] [--bugs] [--detailed] [--summary]"
-```
-默认显示所有活跃需求的概览；指定 REQ_ID 时输出单一详情。
-
-## 执行流程
-
-### 1. 参数解析
-- 验证 ID 格式 (`REQ-\d+` / `BUG-\d+`)。
-- 识别 `--all`、`--bugs`、`--detailed`、`--summary`、`--branches` 等标志。
-
-### 2. 数据收集
-```
-1. 运行 {SCRIPT:prereq} --json --paths-only
-2. 扫描:
-   → devflow/requirements/*/orchestration_status.json
-   → devflow/bugs/*/orchestration_status.json
-3. 读取每个状态文件及 EXECUTION_LOG.md 头部，提取:
-   → status, phase, completedSteps, phase0/phase1 flag, lastUpdated
-   → 是否存在 context-package/task-manifest/report-card/RELEASE_NOTE
-4. 若 `--branches`: 读取 git 分支与 upstream 状态
-5. 若 `--detailed`: 关联 task-manifest 任务统计、report-card 结论、release note
-```
-
-### 3. 输出格式
-- **默认概览**: 表格显示 ID、标题、当前阶段、关键产物完成度、最近更新时间。
-- **详细模式**: 列出各阶段产物路径、phase0/phase1 标志、剩余步骤与下一命令建议。
-- **Summary/All**: 使用 {SCRIPT:generate_status} 生成聚合报告。
-
-### 4. 建议动作
-  - 根据状态字段提示下一命令（优先主链）：
-    - `status=initialized` 或 `status=context_packed` → `/flow:spec`
-    - `status=planned` 或 `status=spec_complete` → `/flow:dev`
-    - `status=development_in_progress` 且有失败任务 → `/flow:dev --resume`
-    - `status=development_complete` → `/flow:verify --strict`
-    - `status=quality_complete` 或 `status=verified` → `/flow:release`
-
-## 输出样例
-```
-📊 CC-DevFlow 状态总览 (更新: 2025-02-10T09:12Z)
-┌─────────┬──────────────┬───────────────┬────────────┬──────────┐
-│ ID      │ Title        │ Status        │ Phase      │ Next     │
-├─────────┼──────────────┼───────────────┼────────────┼──────────┤
-│ REQ-123 │ 下单流程优化   │ planned        │ planning   │ /flow:dev │
-│ REQ-124 │ 权限矩阵       │ quality_complete │ verify  │ /flow:release │
-│ REQ-125 │ 账单导出       │ initialized    │ init       │ /flow:spec │
-└─────────┴──────────────┴───────────────┴────────────┴──────────┘
-```
-
-## 错误处理
-- 找不到 ID → 提示有效目录。
-- 状态文件损坏 → 标记“unknown”，提示用户修复。
-- `--branches` 请求但 Git 不可用 → 输出提示并继续其他数据。

package/.claude/commands/flow/update.md

@@ -1,111 +0,0 @@
----
-name: flow-update
-description: 'Update task progress for cc-devflow requirements. Usage: /flow:update "REQ-123" "T012" [OPTIONS]'
-scripts:
-  prereq: .claude/scripts/check-prerequisites.sh
-  check_tasks: .claude/scripts/check-task-status.sh
-  mark_complete: .claude/scripts/mark-task-complete.sh
-  sync_marks: .claude/scripts/sync-task-marks.sh
----
-
-# Flow-Update - 任务进度更新命令
-
-## User Input
-```text
-$ARGUMENTS = "REQ_ID TASK_ID [--status=STATE] [--progress=PCT] [--estimate=HRS] [--comment='...'] [--auto] [--test]"
-```
-
-## 命令格式
-```text
-/flow:update "REQ_ID" "TASK_ID" [OPTIONS]
-```
-
-### 支持选项
-- `--status=planning|in_progress|blocked|review|completed`
-- `--progress=0-100`
-- `--estimate=<hours>`
-- `--comment="text"`
-- `--auto`：基于 git diff + quickstart 测试估算进度
-- `--test`：运行 quickstart 中相关测试命令
-- `--no-sync`：跳过 TASKS.md 复选框同步
-
-## 执行流程
-
-### 阶段 1: Entry Gate
-```
-1. 参数解析
-   → 解析 REQ_ID、TASK_ID 与选项；校验格式 (REQ-\d+, T### 或 TASK_###)。
-
-2. 环境校验
-   → Run: {SCRIPT:prereq} --json --require-tasks
-   → 确认需求目录、TASKS.md、orchestration_status.json 存在。
-   → 确认当前分支对应 REQ_ID（feature/REQ-*）。
-
-3. 任务校验
-   → Run: {SCRIPT:check_tasks} --json --task "${TASK_ID}"
-   → 阻止更新已完成任务（除非 --status=completed 再次同步）。
-
-4. 快速一致性检查
-   → 若 TASKS.md 中该任务未标记 [ ] → [x]，记录当前状态以便后续同步。
-```
-
-### 阶段 2: 进度采集与验证
-```
-1. --auto 模式
-   → 分析 git diff 涉及的文件。
-   → 检查对应测试文件是否存在。
-   → 估算 progress / status 值（默认阈值：代码 ≥1 文件 → in_progress；测试通过 → review）。
-
-2. --test 模式
-   → 从 quickstart.md 中解析目标测试命令（匹配任务所属阶段）。
-   → 运行并捕获退出码；失败则阻断更新。
-
-3. DoD 对照
-   → 若 --status=completed：
-      • 测试必须通过（或显式跳过 --test 与 --auto）；
-      • `git status --short` 应为空。
-```
-
-### 阶段 3: 状态更新
-```
-1. 更新任务元数据
-   → 在 devflow/requirements/${REQ_ID}/tasks/${TASK_ID}.json 写入最新 status/progress/estimate/comment。
-   → 若任务目录不存在，则创建 tasks/ 并生成 JSON 框架。
-
-2. Mark script
-   → 对已完成任务调用 {SCRIPT:mark_complete} "${TASK_ID}"。
-   → 非完成任务但需要勾选同步时，调用 {SCRIPT:sync_marks}。
-
-3. orchestration_status
-   → 更新 lastTaskUpdate、completedTasks 数、blockers 等字段。
-   → 若所有任务完成且 status ≠ development_in_progress，则设置 status=development_complete。
-
-4. EXECUTION_LOG
-   → 追加进度行，包含任务、状态、备注、测试结果。
-```
-
-### 阶段 4: Exit Gate
-```
-1. 再次调用 {SCRIPT:check_tasks} --json 验证进度已反映在统计中。
-2. 如果 --test，确认测试命令通过且记录在 tasks/${TASK_ID}.json。
-3. 输出摘要（task id、status、progress、下个推荐动作）。
-```
-
-## 错误处理
-- 参数缺失或格式错误 → 立即终止并提示正确示例。
-- git 有未提交变更且 --status=completed → 拒绝更新，提示先提交。
-- 测试失败或 DoD 未满足 → 阻止状态升级为 completed。
-- 同步 TASKS.md 失败 → 提示使用 {SCRIPT:sync_marks} 手动修复。
-
-## 输出
-```
-✅ tasks/${TASK_ID}.json 更新
-✅ TASKS.md 复选框同步（除非 --no-sync）
-✅ orchestration_status.json.lastTaskUpdate 刷新
-✅ EXECUTION_LOG.md 记录本次更新
-```
-
-## 下一步
-- 若所有任务完成：立即运行 `/flow:verify --strict`。
-- 若任务被阻塞：添加 `blocked` 注释并通知相关负责人。
-- 周期性执行 `/flow:status` 获取进度总览。

package/.claude/commands/flow/upgrade.md

@@ -1,115 +0,0 @@
----
-name: flow-upgrade
-description: 'PRD version management, analysis, and application workflow. Usage: /flow:upgrade "REQ-123" --analyze or --version="2.0.0" --reason="..."'
-scripts:
-  prereq: .claude/scripts/check-prerequisites.sh
-  manage_constitution: .claude/scripts/manage-constitution.sh
-  validate_constitution: .claude/scripts/validate-constitution.sh
-  impact_analyzer: .claude/scripts/analyze-upgrade-impact.sh
----
-
-# Flow-Upgrade - PRD 版本管理工作流
-
-## User Input
-```text
-$ARGUMENTS = "REQ_ID [--analyze] [--version=SEMVER] [--reason='...'] [--rollback=SEMVER] [--compatibility --target=SEMVER]"
-```
-
-## 模式
-- `--analyze [--format=json] [--compare=version]`
-- `--version=SEMVER --reason="text" [--force]`
-- `--rollback=SEMVER [--confirm]`
-- `--compatibility [--target=SEMVER] [--baseline=SEMVER]`
-
-## 执行流程
-
-### 阶段 1: Entry Gate
-```
-1. 参数解析
-   → 校验 REQ_ID、版本字符串 (SemVer)、必需理由 (--reason) 等。
-
-2. 前置检查
-   → Run: {SCRIPT:prereq} --json --require-prd
-   → 确认 PRD.md、versions/ 历史目录存在。
-   → Git 工作区需干净（除非只做 analyze）。
-
-3. 状态确认
-   → orchestration_status.status 至少为 "initialized"。
-   → 若后续流程在开发阶段进行，提示可能影响当前迭代。
-```
-
-### 阶段 2A: 分析模式 (--analyze)
-```
-1. 调用 {SCRIPT:impact_analyzer} --req "${REQ_ID}" --compare "${VERSION?}" --format "${FORMAT}"
-2. 输出:
-   → change_detection_*.md
-   → impact_assessment_*.md
-   → upgrade_recommendation_*.md （建议版本 bump: major/minor/patch）
-3. 若 --format=json，打印 JSON 摘要供 CLI 解析。
-```
-
-### 阶段 2B: 升级模式 (--version)
-```
-1. 版本验证
-   → SemVer 合法、未占用。
-   → 提供 --reason。
-   → 若存在 breaking changes 且版本 bump 不够大 → 拒绝或要求 --force。
-
-2. 自动分析
-   → 执行分析模式，生成影响报告。
-   → {SCRIPT:validate_constitution} --type prd --severity warning
-
-3. 版本快照
-   → 创建 devflow/requirements/${REQ}/versions/vX.Y.Z/
-   → 拷贝 PRD.md、TECH_DESIGN.md 等相关文档。
-   → 生成 CHANGELOG 位于 versions/。
-
-4. 元数据更新
-   → 更新 PRD.md 头部版本号、修订日期。
-   → orchestration_status.version = "vX.Y.Z"、lastUpgradeReason。
-   → EXECUTION_LOG.md 记录升级摘要。
-
-5. 触发后续动作
-   → 提示重新运行 `/flow:spec`、`/flow:dev`、`/flow:verify` 等受影响阶段。
-```
-
-### 阶段 2C: 回滚 (--rollback)
-```
-1. 确认目标版本存在。
-2. 如未指定 --confirm，提示用户确认。
-3. 将版本目录内容恢复至当前 PRD。
-4. 更新版本号、记录回滚原因。
-```
-
-### 阶段 2D: 兼容性检查 (--compatibility)
-```
-1. 比对基线与目标版本的差异。
-2. 输出兼容性矩阵（API、数据模型、非功能需求）。
-3. 标记潜在迁移任务。
-```
-
-### 阶段 3: Exit Gate
-```
-1. 核验版本快照目录、CHANGELOG、影响报告是否生成。
-2. 若版本号更新成功，提示下一步（重新跑 `/flow:spec` / `/flow:dev` / `/flow:verify`）。
-3. 失败时保持原状态，给出恢复指引。
-```
-
-## 输出
-```
-✅ versions/vX.Y.Z/ (含 PRD/TECH_DESIGN 快照、CHANGELOG)
-✅ impact_assessment_*.md / upgrade_recommendation_*.md
-✅ orchestration_status.json 更新 (version, lastUpgradeAt, reason)
-✅ EXECUTION_LOG.md 记录
-```
-
-## 错误处理
-- 版本号不合法或已存在 → 终止并提示示例。
-- breaking change 但版本 bump 不够 → 要求确认或提升版本级别。
-- Git 不干净 → 拒绝升级，要求先提交/清理。
-- 影响分析脚本失败 → 续写日志并保持现状。
-
-## 下一步
-- 若版本包含重大变更：立即通知团队重新生成技术方案和规划。
-- 使用 `/flow:status` 检查其他需求是否依赖该版本。
-- 需要宪法变更时调用 `/flow:constitution --amend`。

package/.claude/commands/flow/verify.md

@@ -1,37 +0,0 @@
----
-name: flow-verify
-description: 'Run layered quality gates and produce report-card. Usage: /flow:verify "REQ-123" [--strict] [--skip-review]'
-skill: workflow/flow-verify
----
-
-# Flow-Verify Command (Harness Gates)
-
-> 触发入口：执行细节由 `.claude/skills/workflow/flow-verify/SKILL.md` 定义。
-
-## User Input
-
-```text
-$ARGUMENTS = "REQ_ID [--strict] [--skip-review]"
-```
-
-## Usage
-
-```bash
-/flow:verify "REQ-123"
-/flow:verify "REQ-123" --strict
-/flow:verify "REQ-123" --strict --skip-review
-```
-
-## Internal Execution
-
-- `npm run harness:verify -- --change-id <REQ_ID> [--strict] [--skip-review]`
-
-## Output
-
-- `devflow/requirements/<REQ_ID>/report-card.json`
-
-## Next Step
-
-```bash
-/flow:release "<REQ_ID>"
-```

package/.claude/commands/flow/workspace.md

@@ -1,155 +0,0 @@
----
-name: flow-workspace
-description: Manage developer workspace and session persistence (RM-018)
-version: 3.0.0
----
-
-# /flow-workspace
-
-> **[PROTOCOL]**: 变更时更新此头部，然后检查 CLAUDE.md
-
-## Purpose
-
-Manage developer workspaces for session persistence.
-Enables context recovery across sessions and tracks development progress.
-
-## Usage
-
-```bash
-# Initialize workspace for a developer
-/flow-workspace init [developer]
-
-# Start session (recover context)
-/flow-workspace start [REQ-XXX|BUG-XXX]
-/flow-workspace start REQ-XXX --switch
-/flow-workspace start BUG-XXX --switch --cd  # 需 source/eval 场景
-
-# Record progress to journal
-/flow-workspace record "message"
-
-# Switch to different requirement
-/flow-workspace switch REQ-XXX
-/flow-workspace switch BUG-XXX --cd            # 需 source/eval 场景
-```
-
-## Subcommands
-
-### init
-
-Initialize a workspace for a developer.
-
-```bash
-/flow-workspace init dimon
-```
-
-Creates:
-```
-devflow/workspace/dimon/
-├── .current-req    # Current requirement ID
-├── journal-1.md    # Session journal
-└── ...
-```
-
-### start
-
-Start a new session, recovering context from previous session.
-
-```bash
-/flow-workspace start
-/flow-workspace start REQ-008 --switch
-/flow-workspace start BUG-008 --switch
-```
-
-Process:
-1. Read `.current-req` to get current requirement
-2. Read latest journal entries
-3. Display context summary
-4. Ready to continue work
-
-可选行为:
-- 传入 `REQ-XXX/BUG-XXX` 会先更新 `.current-req` 再恢复上下文
-- `--switch` 输出切换建议；`--cd` 在脚本被 `source` 时可直接切换目录
-
-### record
-
-Record progress to the journal.
-
-```bash
-/flow-workspace record "Completed T015, starting T016"
-```
-
-Appends to current journal file. Creates new journal file when approaching 2000 lines.
-
-### switch
-
-Switch to a different requirement.
-
-```bash
-/flow-workspace switch REQ-008
-/flow-workspace switch REQ-008 --cd
-```
-
-Updates `.current-req` and creates a new journal entry.
-
-## Workspace Structure
-
-```
-devflow/workspace/
-├── index.md            # Active developers list
-└── {developer}/
-    ├── .current-req    # Current REQ-ID (e.g., "REQ-007")
-    ├── journal-1.md    # Session journal (max 2000 lines)
-    ├── journal-2.md    # Overflow journal
-    └── ...
-```
-
-## Journal Format
-
-```markdown
-## [2026-02-06 10:30] Session Start
-
-**REQ**: REQ-007
-**Phase**: flow-dev
-**Task**: T015
-
-### Progress
-- Completed: T014 (auth middleware)
-- Current: T015 (rate limiting)
-- Blocked: None
-
-### Notes
-- Discovered edge case in token refresh
-- Need to revisit error handling in T016
-```
-
-## Integration
-
-### With flow-init
-
-When `/flow:init` creates a new requirement (and workspace already initialized):
-```bash
-# Auto-update workspace
-echo "REQ-XXX" > devflow/workspace/{developer}/.current-req
-```
-
-### With flow-dev
-
-During development, progress is automatically recorded:
-```bash
-/flow-workspace record "Completed T015"
-```
-
-### With Attention Refresh
-
-Journal is read at Protocol 3 (Ralph iteration start) to maintain context.
-
-## Scripts
-
-- `.claude/scripts/flow-workspace-init.sh` - Initialize workspace
-- `.claude/scripts/flow-workspace-record.sh` - Record progress
-
-## Related
-
-- **Template**: `.claude/docs/templates/JOURNAL_TEMPLATE.md`
-- **Index**: `devflow/workspace/index.md`
-- **Attention Refresh**: `.claude/skills/flow-attention-refresh/SKILL.md`