🎉 命令解耦 — 三命令智能协作
把单一 /testvdb:mine 流水线拆成三个可独立触发、智能协作的子命令。mine 在不显式指定时自动判断是否需要先跑前两者。
✨ 新特性
三命令解耦
/testvdb:contract <db> <version> [--force]— 独立文档提取 + 契约生成(knowledge-extractor → contract-formalizer → 门控)/testvdb:intel <db> [--max-issues N] [--max-commits N] [--force]— 独立情报采集 + 威胁建模(issue-miner → bug-shape → threat-modeler)/testvdb:mine <db> <version> [--intel|--contract] [...]— 攻击挖掘(智能消费 intel/contract 缓存)
智能 D 判断(scripts/check_cache.py)
四条件缓存复用检测:存在 → TTL 新鲜 → 有效 → target/version 匹配
- 全满足 → 纯挖掘(跳过生成,省时)
- 任一不满足 → 重新生成
- CacheStatus:
USABLE/MISSING/STALE/INVALID/MISMATCH
C 边界(--intel / --contract false)
区分"我有但想用旧的" vs "压根没有"——避免无前置产物时静默挖掘:
| 缓存状态 | --xxx false 行为 |
|---|---|
| MISSING | 报错退出("缺失,请先 /testvdb:xxx") |
| STALE / INVALID | 用现有 + 警告(不刷新) |
| USABLE | 正常使用 |
✅ 端到端验收(CC 2.1.165)
5 场景验收,4/5 PASS(场景 4 核心点被场景 1 --force 覆盖——同一 agent 派发链):
| 场景 | 结果 | 证据 |
|---|---|---|
| contract 独立 | ✅ | 双重:缓存命中(weaviate 1.38.0, 83端点) + 真实 --force(milvus 2.4.0, 30端点/门控PASS) |
| intel 独立 | ✅ | 真实端到端(pgvector):issue-miner(25+11) → bug-shape(7) → threat-modeler(6盲点/3攻击面) |
| mine 缓存有效 | ✅ | 智能消费决策路径(contract+intel 双 USABLE→跳过→进挖掘) |
| mine --contract false | ✅ | C 边界:无契约 → MISSING → 报错退出 |
5 种 Agent 全部派发成功,零 unknown:knowledge-extractor / contract-formalizer / issue-miner / bug-shape-extractor / threat-modeler
📊 质量
- pytest:55 passed, 1 skipped(无回归,+7 check_cache)
agents/orchestrator.md瘦化 834 → 767 行(<800)- TDD:check_cache 测试先行,发现并修复 spec 决策 4 顺序 bug(有效性应先于 target/version 匹配)
📦 变更清单
- ➕
scripts/check_cache.py+tests/test_check_cache.py(D 判断核心,7 passed TDD) - ➕
commands/contract.md+commands/intel.md(独立命令,完整 agent prompt) - ♻️
commands/mine.md重构(智能消费,原地升级保编号——避免合并重编号破坏 Step 顺序) - ♻️
agents/orchestrator.md瘦化(情报/契约编排引用 intel/contract 命令) - ⚙️
.claude-plugin/plugin.json注册 intel/contract 命令 + version 2.1.1 → 2.2.0 - 📝
README.md+README_zh.md中英双语重写
🔗 关联
- PR #13:#13
- Spec / Plan:
docs/superpowers/specs/2026-06-14-batch-d-command-decoupling-design.md - 前序版本:v2.1.3(反偷工减料流水线门禁)
完整文档:README.md(English)| README_zh.md(中文)