cc-devflow 1.0.3 → 2.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/CLAUDE.md +123 -4
- package/.claude/agents/code-quality-reviewer.md +205 -0
- package/.claude/agents/spec-reviewer.md +221 -0
- package/.claude/commands/cancel-ralph.md +59 -0
- package/.claude/commands/flow-dev.md +202 -21
- package/.claude/commands/flow-epic.md +33 -0
- package/.claude/commands/flow-fix.md +138 -20
- package/.claude/commands/flow-init.md +104 -15
- package/.claude/commands/flow-new.md +84 -35
- package/.claude/commands/flow-prd.md +16 -3
- package/.claude/commands/flow-release.md +33 -0
- package/.claude/commands/flow-review.md +257 -0
- package/.claude/docs/templates/ATTEMPT_TEMPLATE.md +156 -0
- package/.claude/docs/templates/BRAINSTORM_TEMPLATE.md +148 -0
- package/.claude/docs/templates/ERROR_LOG_TEMPLATE.md +80 -0
- package/.claude/docs/templates/INIT_FLOW_TEMPLATE.md +22 -14
- package/.claude/guides/workflow-guides/flow-orchestrator.md +2 -2
- package/.claude/hooks/hooks.json +15 -0
- package/.claude/hooks/ralph-stop-hook.sh +190 -0
- package/.claude/rules/devflow-conventions.md +3 -1
- package/.claude/rules/project-constitution.md +256 -2
- package/.claude/rules/rationalization-library.md +282 -0
- package/.claude/scripts/create-requirement.sh +19 -6
- package/.claude/scripts/setup-ralph-loop.sh +155 -0
- package/.claude/scripts/verify-gate.sh +269 -0
- package/.claude/skills/cc-devflow-orchestrator/SKILL.md +70 -20
- package/.claude/skills/file-header-guardian/SKILL.md +56 -0
- package/.claude/skills/flow-attention-refresh/SKILL.md +170 -0
- package/.claude/skills/flow-brainstorming/SKILL.md +161 -0
- package/.claude/skills/flow-debugging/SKILL.md +221 -0
- package/.claude/skills/flow-finishing-branch/SKILL.md +189 -0
- package/.claude/skills/flow-receiving-review/SKILL.md +153 -0
- package/.claude/skills/flow-tdd/SKILL.md +218 -0
- package/.claude/skills/fractal-docs-generator/SKILL.md +45 -0
- package/.claude/skills/skill-rules.json +75 -0
- package/.claude/skills/verification-before-completion/SKILL.md +158 -0
- package/README.md +104 -19
- package/README.zh-CN.md +79 -1
- package/docs/commands/flow-init.md +3 -1
- package/docs/commands/flow-init.zh-CN.md +3 -1
- package/package.json +1 -1
- package/.claude/tsc-cache/777aa1de-497e-411b-a40f-13b74efcec58/affected-repos.txt +0 -1
package/README.zh-CN.md
CHANGED
|
@@ -29,6 +29,7 @@
|
|
|
29
29
|
- 🔍 **一致性验证** - 企业级一致性检查,智能冲突检测
|
|
30
30
|
- 🧪 **TDD 强制执行** - 严格的测试驱动开发,TEST VERIFICATION CHECKPOINT
|
|
31
31
|
- 📜 **Constitution** - 10条宪法条款管控质量、安全和架构
|
|
32
|
+
- 🔄 **自主开发** - Ralph × Manus 集成实现有记忆的持续迭代
|
|
32
33
|
- 🔌 **多平台支持** - 通过 `npm run adapt` 编译工作流到 Codex、Cursor、Qwen、Antigravity
|
|
33
34
|
|
|
34
35
|
---
|
|
@@ -471,7 +472,84 @@ bash .claude/tests/run-all-tests.sh --scripts
|
|
|
471
472
|
|
|
472
473
|
## 📝 版本历史
|
|
473
474
|
|
|
474
|
-
### v2.
|
|
475
|
+
### v2.3.0 (2026-01-08) - 最新版本
|
|
476
|
+
|
|
477
|
+
**🛡️ 纪律系统:铁律 + 合理化防御 + 压力测试**
|
|
478
|
+
|
|
479
|
+
v2.3.0 将 Constitution 从"文档"升级为"可执行纪律系统",借鉴 superpowers 项目最佳实践:
|
|
480
|
+
|
|
481
|
+
- **铁律 + 合理化表格** - 预先阻止 AI Agent 合理化尝试
|
|
482
|
+
- 10 条 Constitution 条款现在都有铁律(绝对禁止)
|
|
483
|
+
- 合理化表格采用 `| 借口 | 现实 |` 格式
|
|
484
|
+
- 红旗标志用于 AI 自检触发
|
|
485
|
+
- 集中式 `rationalization-library.md` 存储所有合理化
|
|
486
|
+
|
|
487
|
+
- **两阶段代码审查** - `/flow-review` 命令(新增)
|
|
488
|
+
- 阶段 1:规格合规性(不信任实现者报告,直接读代码)
|
|
489
|
+
- 阶段 2:代码质量(仅在阶段 1 通过后运行)
|
|
490
|
+
- `spec-reviewer.md` 和 `code-quality-reviewer.md` 代理
|
|
491
|
+
|
|
492
|
+
- **完成前验证** - 断言前先有证据
|
|
493
|
+
- `verification-before-completion` 技能
|
|
494
|
+
- `verify-gate.sh` 脚本用于所有流程出口闸门
|
|
495
|
+
- 没有新鲜验证证据不得声称完成
|
|
496
|
+
|
|
497
|
+
- **系统化调试** - `/flow-fix` 增强 4 阶段调试
|
|
498
|
+
- 阶段 1:根因调查(尚未修复)
|
|
499
|
+
- 阶段 2:模式分析
|
|
500
|
+
- 阶段 3:假设和测试
|
|
501
|
+
- 阶段 4:TDD 实现
|
|
502
|
+
- `flow-debugging` 和 `flow-tdd` 技能
|
|
503
|
+
|
|
504
|
+
- **头脑风暴集成** - `/flow-init` 现在包含头脑风暴
|
|
505
|
+
- `BRAINSTORM.md` 作为需求"北极星"
|
|
506
|
+
- `/flow-prd` 需要 BRAINSTORM 对齐检查
|
|
507
|
+
- `flow-brainstorming` 技能
|
|
508
|
+
|
|
509
|
+
- **压力测试框架** - 技能的 TDD
|
|
510
|
+
- `tests/pressure-scenarios/` 包含 4 个场景
|
|
511
|
+
- 测试 AI 在时间/沉没成本/权威/疲劳压力下的行为
|
|
512
|
+
- `run-pressure-tests.sh` 运行器
|
|
513
|
+
|
|
514
|
+
- **技能融合** - Superpowers 技能迁移到本地
|
|
515
|
+
- `flow-tdd`、`flow-debugging`、`flow-receiving-review`、`flow-finishing-branch`
|
|
516
|
+
- 所有 `superpowers:xxx` 引用替换为本地技能
|
|
517
|
+
|
|
518
|
+
- **Ralph × Manus 集成** - 有记忆的自主开发(新增)
|
|
519
|
+
- 合并入 `/flow-dev` (默认自主模式)
|
|
520
|
+
- `flow-attention-refresh` 技能提供 4 个刷新协议
|
|
521
|
+
- `ERROR_LOG.md` 结构化错误追踪
|
|
522
|
+
- `research/attempts/` 失败痕迹记录
|
|
523
|
+
- Stop Hook 实现自引用循环
|
|
524
|
+
- `/flow-init` Stage 2.5 融入 Manus 研究方法
|
|
525
|
+
- 目标:无人工干预任务完成率 ≥85%
|
|
526
|
+
|
|
527
|
+
**📋 Constitution v2.1.0**:
|
|
528
|
+
- 所有 10 条条款现在都有铁律 + 合理化防御 + 红旗标志
|
|
529
|
+
- 交叉引用到 `rationalization-library.md`
|
|
530
|
+
|
|
531
|
+
**📁 新增文件**:
|
|
532
|
+
- `.claude/commands/cancel-ralph.md` - 取消 Ralph 循环命令
|
|
533
|
+
- `.claude/skills/flow-attention-refresh/SKILL.md` - 4 个注意力刷新协议
|
|
534
|
+
- `.claude/hooks/ralph-stop-hook.sh` - 自引用循环 Stop Hook
|
|
535
|
+
- `.claude/hooks/hooks.json` - Hook 注册配置
|
|
536
|
+
- `.claude/scripts/setup-ralph-loop.sh` - Ralph 状态初始化脚本
|
|
537
|
+
- `.claude/docs/templates/ERROR_LOG_TEMPLATE.md` - 执行错误日志格式
|
|
538
|
+
- `.claude/docs/templates/ATTEMPT_TEMPLATE.md` - 研究尝试日志格式
|
|
539
|
+
- `.claude/agents/spec-reviewer.md` - 阶段 1 规格合规性审查员
|
|
540
|
+
- `.claude/agents/code-quality-reviewer.md` - 阶段 2 代码质量审查员
|
|
541
|
+
- `.claude/commands/flow-review.md` - 两阶段审查命令
|
|
542
|
+
- `.claude/rules/rationalization-library.md` - 集中式合理化防御
|
|
543
|
+
- `.claude/scripts/verify-gate.sh` - 出口闸门验证脚本
|
|
544
|
+
- `.claude/skills/flow-brainstorming/` - 头脑风暴技能
|
|
545
|
+
- `.claude/skills/flow-debugging/` - 系统化调试技能
|
|
546
|
+
- `.claude/skills/flow-tdd/` - TDD 强制执行技能
|
|
547
|
+
- `.claude/skills/flow-receiving-review/` - 审查反馈处理技能
|
|
548
|
+
- `.claude/skills/flow-finishing-branch/` - 分支完成决策技能
|
|
549
|
+
- `.claude/skills/verification-before-completion/` - 完成验证技能
|
|
550
|
+
- `tests/` - 压力测试框架
|
|
551
|
+
|
|
552
|
+
### v2.2.0 (2025-12-19)
|
|
475
553
|
|
|
476
554
|
**🔌 多平台适配:Agent 适配器架构 + 命令编译器**
|
|
477
555
|
|
|
@@ -22,6 +22,8 @@ Initialize requirement directory structure and load roadmap and architecture con
|
|
|
22
22
|
|-----------|-------------|----------|---------|
|
|
23
23
|
| **REQ-ID** | Requirement number | ✅ | `REQ-123` |
|
|
24
24
|
| **Feature Title** | Brief description | ✅ | `User Authentication Feature` |
|
|
25
|
+
|
|
26
|
+
> If the title contains non-ASCII text, the agent produces an English semantic translation for branch naming (not pinyin), while keeping the original title in docs.
|
|
25
27
|
| **--interactive** | Interactive ID selection | ❌ | Auto-select next available ID |
|
|
26
28
|
|
|
27
29
|
## 🎬 Use Cases
|
|
@@ -68,7 +70,7 @@ Stage 2.6: Research task dispatch & decision integration
|
|
|
68
70
|
└─ Consolidate research findings
|
|
69
71
|
↓
|
|
70
72
|
Stage 3: Git branch creation
|
|
71
|
-
└─ Create feature/REQ-XXX-
|
|
73
|
+
└─ Create feature/REQ-XXX-english-slug branch (model-translated, not pinyin)
|
|
72
74
|
```
|
|
73
75
|
|
|
74
76
|
## 💡 Examples
|
|
@@ -20,6 +20,8 @@
|
|
|
20
20
|
| **功能标题** | 简短描述 | ✅ | `用户认证功能` |
|
|
21
21
|
| **--interactive** | 交互式选择 ID | ❌ | 自动选择下一个可用 ID |
|
|
22
22
|
|
|
23
|
+
> 若标题包含中文/非ASCII,分支名将使用模型意译生成英文语义短语(禁止拼音/音译),文档标题仍保留原始中文。
|
|
24
|
+
|
|
23
25
|
## 🎬 使用场景
|
|
24
26
|
|
|
25
27
|
### ✅ 推荐场景
|
|
@@ -65,7 +67,7 @@ Stage 2.6: 调研任务分派与决策整合(FIXED)
|
|
|
65
67
|
└─ 整合研究结论 (consolidate-research.sh)
|
|
66
68
|
↓
|
|
67
69
|
Stage 3: Git 分支创建
|
|
68
|
-
└─ 创建 feature/REQ-123-user-auth
|
|
70
|
+
└─ 创建 feature/REQ-123-user-auth 分支(标题英文意译,非拼音)
|
|
69
71
|
```
|
|
70
72
|
|
|
71
73
|
## 💡 示例
|
package/package.json
CHANGED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
root
|