soloforge 1.4.3 → 1.4.5

package/templates/knowledge/rules//344/273/243/347/240/201/346/263/250/351/207/212/344/270/216/346/227/245/345/277/227/345/245/221/347/272/246/350/247/204/345/210/231.md

@@ -72,8 +72,8 @@ last_reviewed: '2026-05-26'
 
 ### 必须有注释
 - 业务规则不直观时
-- 领域不变量（如"一个长者同一时间只能有一个有效入住"）
-- 金额、账单、补贴、支付、退款、核销逻辑
+- 领域不变量（如"一个用户同一时间只能有一个有效业务办理"）
+- 金额、账单、折扣、支付、退款、核验逻辑
 - 状态流转逻辑（如 pending → paid → refunded）
 - 幂等、分布式锁、事务、并发控制
 - 权限、安全、审计判断
@@ -95,8 +95,8 @@ last_reviewed: '2026-05-26'
 - 用户登录、登出、认证失败
 - 权限拒绝、越权访问
 - 创建、修改、删除关键业务对象
-- 状态变更、金额变更、支付、退款、补贴、核销
-- 合同、入住、账单、证照、人员角色变更
+- 状态变更、金额变更、支付、退款、折扣、核验
+- 合同、业务办理、账单、证照、人员角色变更
 - 外部 API 调用失败、超时、重试
 - 异步任务开始、成功、失败、重试、跳过
 - 数据修复、批处理、迁移脚本

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 导航建议，但必须包含：

package/templates/knowledge/rules//350/256/276/350/256/241/344/272/247/347/211/251/345/214/205/350/247/204/345/210/231.md

@@ -43,10 +43,26 @@ status: active
 
 - 决策和确认以 `00-架构决策记录.md` 为准。
 - 总体架构以 `01-架构设计文档.md` 为准。
+- 详细设计的必需承载是 `02-数据库设计文档.md` 和 `03-API接口规格文档.md`；`04-详细设计文档.md` 只是兼容旧项目或复杂模块的可选补充，不得被门禁强制要求。
 - 数据库物理结构以真实 SQL/migration 为准，`02-数据库设计文档.md` 解释和追踪。
 - API 路径和字段 schema 以 `docs/api/openapi.yaml` 为准，`03-API接口规格文档.md` 补充业务语义。
+- 开发切片以 `04-开发切片计划.md` 为准，作为全项目切片索引承载 `PHASE-*`、`SLICE-*`、状态、依赖和验收顺序；旧 `04-第一阶段开发切片计划.md` 只能作为迁移提示，不得作为新项目标准输出，也不得单独作为设计产物包通过依据。
+- 需求、原型、架构、详细设计、切片、实现和验收之间的身份关系以 `docs/traceability/01-需求原型设计实现追踪矩阵.md` 为准。
 - `99-设计一致性验收报告.md` 只记录真实验证结果。
 
+## 生命周期输入输出
+
+| 节点 | 必需输入 | 必需输出 | 进入下一节点的硬门禁 |
+| --- | --- | --- | --- |
+| 需求输入 | 用户需求材料 | `REQ-*` 与需求文档 | 需求进入追踪矩阵 |
+| 原型提取 | 原型材料 | `PROTO-*` 与原型说明 | 原型进入追踪矩阵 |
+| 架构设计 | `REQ-*`、`PROTO-*` | `00-架构决策记录.md`、`01-架构设计文档.md`、`ARCH-*` | 架构引用需求或原型，决策已确认 |
+| 详细设计 | `ARCH-*` | `02-数据库设计文档.md`、`03-API接口规格文档.md`、`DD-T*`、`DD-A*`、OpenAPI、SQL/migration | DB/API 设计引用架构，OpenAPI 和 SQL 权威资产存在 |
+| 切片规划 | `DD-*` 或 `ARCH-*` | `04-开发切片计划.md`、`PHASE-*`、`SLICE-*`、`AC-*` | 切片绑定阶段、设计来源和验收 ID |
+| 实现 | 追踪矩阵与切片计划 | 真实 `changed_files` | 任务绑定 `SLICE-*`、`DD-*`、`AC-*` |
+| 测试 | 真实 `changed_files` 与验收 ID | 真实命令执行结果 | 不能把验证计划当验证结果，验证必须覆盖变更 |
+| 验收/交付 | 测试结果和设计产物包 | `99-设计一致性验收报告.md` 与交付摘要 | hard_fail 清零并保留消费 trace |
+
 ## 硬底线
 
 - 每个 endpoint 必须具备请求和响应字段级说明，JSON 示例不能替代字段表。