soloforge 1.4.2 → 1.4.4

package/templates/knowledge/acceptance_templates//351/234/200/346/261/202/345/216/237/345/236/213/350/256/276/350/256/241/345/256/236/347/216/260/350/277/275/350/270/252/347/237/251/351/230/265/346/250/241/347/211/210.md

@@ -0,0 +1,98 @@
+---
+name: 需求原型设计实现追踪矩阵模版
+id: ka-artifact_template-design-implementation-traceability-matrix
+asset_kind: artifact_template
+lifecycle_status: active
+authority: supporting
+scope:
+  - all
+products:
+  - '*'
+routes:
+  - artifact_generation
+  - code_change
+primary_triggers:
+  - 追踪矩阵
+  - 需求原型设计实现追踪
+  - 需求到编码追踪
+priority: P0
+specificity: 5
+version: 1.0.0
+last_reviewed: '2026-05-28'
+owner_mechanism_id: mc-design-artifact-pack
+consumes:
+  - docs/requirements.md
+  - docs/prototype.md
+  - docs/architecture/01-架构设计文档.md
+  - docs/architecture/04-详细设计文档.md
+emits:
+  - docs/traceability/01-需求原型设计实现追踪矩阵.md
+required_evidence:
+  - REQ/PROTO/ARCH/DD/SLICE/AC 全链路 ID
+  - design_artifact_pack_verification
+  - changed_files_traceability_binding
+type: acceptance_template
+status: active
+---
+
+# 需求原型设计实现追踪矩阵
+
+输出路径：`docs/traceability/01-需求原型设计实现追踪矩阵.md`
+
+## 1. ID 规则
+
+- 需求：`REQ-001`
+- 原型：`PROTO-001`
+- 架构：`ARCH-001`
+- 详细设计：`DD-001`
+- 实现切片：`SLICE-001`
+- 验收：`AC-001`
+
+## 2. 总矩阵
+
+| 需求 ID | 需求摘要 | 原型 ID | 架构 ID | 详细设计 ID | 切片 ID | 验收 ID | 状态 | 证据/文件 |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| REQ-001 |  | PROTO-001 | ARCH-001 | DD-001 | SLICE-001 | AC-001 | planned |  |
+
+## 3. 上游来源
+
+| ID | 来源文件 | 来源章节 | 关键结论 |
+| --- | --- | --- | --- |
+| REQ-001 |  |  |  |
+| PROTO-001 |  |  |  |
+
+## 4. 设计承接
+
+| 设计 ID | 上游 ID | 文件 | 设计结论 | 影响范围 |
+| --- | --- | --- | --- | --- |
+| ARCH-001 | REQ-001, PROTO-001 | docs/architecture/01-架构设计文档.md |  |  |
+| DD-001 | ARCH-001 | docs/architecture/04-详细设计文档.md |  |  |
+
+## 5. 切片与验收
+
+| 切片 ID | 设计来源 | 验收 ID | 计划变更文件 | 验收标准 |
+| --- | --- | --- | --- | --- |
+| SLICE-001 | DD-001 | AC-001 |  |  |
+
+## 6. 变更记录
+
+| 日期 | 变更 | 影响 ID | 处理结论 |
+| --- | --- | --- | --- |
+|  |  |  |  |
+
+## 7. 复验闭环
+
+生成或修改本矩阵后必须执行：
+
+```bash
+soloforge audit-design-artifacts
+soloforge next
+```
+
+进入编码前必须确认：
+
+- `audit-design-artifacts` 无追踪矩阵阻断项。
+- 架构设计引用 `REQ-*` 或 `PROTO-*`。
+- 详细设计引用 `ARCH-*` 并声明 `DD-*`。
+- 切片计划引用 `DD-*` 或 `ARCH-*`，并声明 `SLICE-*` 和 `AC-*`。
+- 编码任务上下文包含本次实现对应的 `SLICE-*`、`DD-*`、`AC-*`。

package/templates/knowledge/procedures//345/205/250/347/224/237/345/221/275/345/221/250/346/234/237/345/267/245/344/275/234/346/265/201/345/257/274/350/210/252.md

@@ -97,6 +97,19 @@ status: active
 - 选择"归档"：将旧任务标记为归档，清理指针
 - 选择"新建"：归档旧任务后开始新任务
 - 不得绕过 SoloForge 直接操作
+- 归档只处理陈旧指针，不是直接写业务代码的许可
+
+## 阻断恢复
+
+当 Edit、Write、Bash 或 MCP 工具被 SoloForge 阻断时：
+
+- 先读取阻断输出中的 `recovery_command`、`template_path` 和 `confirmation_decisions`
+- 自动修复项按命令修复后重试对应工具
+- 业务确认项列出具体必须确认内容后等待用户确认
+- 不得取消任务后直接写代码
+- 不得改用 Bash 绕过受控任务、设计复验或追踪矩阵
+- 不得手动删除 `.soloforge/state`
+- 若确认为陈旧任务，必须通过 `sf_status action=archive_stale confirm=true` 或导航推荐命令归档，再重新 `sf_classify -> sf_expand`
 
 ## 常见导航场景
 

package/templates/knowledge/rules//345/267/245/344/275/234/346/265/201/345/257/274/350/210/252/345/245/221/347/272/246/350/247/204/345/210/231.md

@@ -105,10 +105,22 @@ AI 不得只说“需要确认”。必须说明哪些是必须确认、哪些
 
 - **不得绕过 SoloForge 状态直接操作**
 - **不得说"无需 SoloForge 状态"然后自由发挥**
+- **不得把取消、归档或 Bash 写入当作恢复路径**
 - 必须从三个选项中选择：恢复旧任务 / 归档旧任务 / 开始新任务
 - 旧任务文件不得静默删除，只处理 current-task 指针
 - 选择必须留有审计痕迹
 
+## 阻断恢复协议
+
+当 SoloForge 的 Edit/Write/Bash hook 或 MCP 工具返回阻断时：
+
+- 不得建议“取消任务后直接写代码”。
+- 不得建议“先用 Bash 直接修改业务代码”。
+- 不得建议手动删除或清理 `.soloforge/state`。
+- 不得把“先实现后补验证”作为恢复路径。
+- 必须按工具返回的 `recovery_command`、`soloforge next`、`sf_expand`、`sf_verify` 或经用户确认的 `sf_status action=archive_stale confirm=true` 恢复。
+- 只有 `soloforge next` 或 `sf_status` 明确判定 current-task 陈旧时才允许归档；归档后仍必须重新 `sf_classify -> sf_expand` 建立受控任务，不能直接写代码。
+
 ## Override 协议
 
 用户可以显式 override 导航建议，但必须包含：