soloforge 1.4.16 → 2.0.0

package/templates/knowledge/rules//347/224/250/346/210/267/345/217/215/351/246/210/345/245/221/347/272/246/350/247/204/345/210/231.md

@@ -1,118 +0,0 @@
----
-name: 用户反馈契约规则
-scope:
-  - '*'
-products:
-  - '*'
-id: ka-hard-rule-用户反馈契约规则
-asset_kind: hard_rule
-lifecycle_status: active
-authority: canonical
-owner_mechanism_id: mc-user-feedback
-routes:
-  - 用户反馈契约规则
-primary_triggers:
-  - 用户反馈契约规则
-  - 用户反馈
-  - 实际使用反馈
-  - 问题反馈
-  - 机制缺口
-  - 设计缺陷
-secondary_triggers:
-  - 全局抽象
-  - 系统性问题
-  - 机制族归因
-  - 用户项目路径
-  - 防回归
-negative_triggers: []
-priority: P0
-specificity: 5
-consumes:
-  - mc-task-context-lifecycle
-  - mc-first-principles
-  - mc-detail-discipline
-  - mc-evolution-regression
-hard_blocks:
-  - 反馈未响应
-  - 阻塞性信息未展示
-  - 仅按表面文件或单个场景收窄处理
-  - 未做机制族归因
-  - 未分析 SoloForge 自身与用户项目双路径影响
-  - 未分析模板层、知识层、机制层、adapter、CLI、MCP、发布门禁、迁移和防回归影响
-fallback: manual_required
-required_evidence:
-  - user_feedback_message
-  - global_abstraction_review
-  - mechanism_family_mapping
-  - cross_layer_impact_matrix
-version: 1.0.0
-last_reviewed: '2026-05-22'
-migration_note: 知识资产标准化迁移
-type: hard_rule
-when: 用户反馈契约规则
-status: active
----
-
-# 用户反馈契约规则
-
-## 核心约束
-
-1. 每个工具只能输出其 `getAllowedFeedbackKinds` 允许的反馈类型。
-2. 反馈消息必须包含：kind、severity、title、summary。禁止空洞反馈。
-3. 技术内容（路径、命令、错误码）禁止翻译，必须保留原文。
-4. `blocked` 类型反馈必须包含阻塞原因和建议下一步。
-5. `failure` 类型反馈必须包含失败证据和 retry_hint。
-6. 任何用户反馈、缺陷、设计疑问或实际使用偏差，不得只按表面文件、单个目录或单个场景收窄处理。
-7. 进入修复讨论前，必须先完成全局抽象审查：
-   - 该问题属于哪个机制族？
-   - 是否只是某个现象暴露出来的系统性问题？
-   - 是否同时影响 SoloForge 自身与用户项目使用路径？
-   - 是否涉及模板层、知识层、机制层、adapter、CLI、MCP、发布门禁、迁移和防回归？
-   - 是否需要抽象成通用能力，而不是只修当前案例？
-8. 如果全局抽象审查未完成，只能输出待分析项、影响矩阵和建议讨论顺序，不得直接给单点修复结论。
-9. 如果当前案例只是系统性问题的一个样本，修复方案必须覆盖同类入口、同类资产、同类任务和新增资产防回归。
-
-## 适用场景
-
-- 所有 SoloForge 工具的输出反馈
-- sf_verify 结果反馈
-- sf_learn 学习反馈
-- sf_expand 降级/澄清反馈
-- 用户反馈实际使用问题
-- 讨论新增机制、模板、规则、流程、验收或发布风险
-- 将问题落入 Batch、备忘录、发布门槛或施工合同前
-
-## 违规处理
-
-- 禁止的反馈类型 → hard_fail，阻断输出
-- 空洞反馈 → advisory，标记质量降级
-- 翻译技术内容 → advisory，标记违规
-- 未做全局抽象审查就收窄为单点修复 → hard_fail，退回机制族归因
-- 只修当前文件/目录/样例但未覆盖同类路径和防回归 → hard_fail，要求补齐通用能力
-- 未分析 SoloForge 自身与用户项目双路径影响 → hard_fail，要求补齐影响矩阵
-- 未说明模板层、知识层、机制层、adapter、CLI、MCP、发布门禁、迁移和防回归影响 → hard_fail，要求补齐跨层影响
-
-## 全局抽象审查输出
-
-每次用户反馈进入讨论或施工合同前，必须形成以下结构化结论：
-
-```text
-1. 表面现象:
-2. 机制族归因:
-3. 是否系统性问题:
-4. SoloForge 自身影响:
-5. 用户项目影响:
-6. 涉及层级:
-   - 模板层:
-   - 知识层:
-   - 机制层:
-   - adapter:
-   - CLI:
-   - MCP:
-   - 发布门禁:
-   - 迁移:
-   - 防回归:
-7. 是否应抽象成通用能力:
-8. 不应只修的局部案例:
-9. 施工和验收必须覆盖的同类路径:
-```

package/templates/knowledge/rules//347/237/245/350/257/206/346/262/273/347/220/206/350/247/204/345/210/231.md

@@ -1,50 +0,0 @@
----
-name: 知识治理规则
-scope:
-  - '*'
-products:
-  - '*'
-id: ka-hard-rule-知识治理规则
-asset_kind: hard_rule
-lifecycle_status: active
-authority: canonical
-owner_mechanism_id: mc-knowledge-governance
-routes:
-  - verification
-  - operation
-  - knowledge_update
-primary_triggers:
-  - 知识治理
-  - 知识演进
-  - 文档治理
-secondary_triggers:
-  - 中文语义
-  - language policy
-negative_triggers:
-  - 普通代码修改
-priority: P0
-specificity: 5
-consumes:
-  - knowledge_governance_gate
-hard_blocks:
-  - promotion_without_evidence
-  - unauthorized_design_doc_fact
-  - language_policy_missing
-fallback: manual_required
-required_evidence:
-  - knowledge_governance_report
-version: 1.0.0
-last_reviewed: '2026-05-26'
-status: active
----
-
-# 知识治理规则
-
-知识资产从草稿、演进、同步到注入必须有统一治理入口。
-
-## 硬规则
-
-- 知识晋级必须有证据，不能由 AI 推理直接变成核心事实。
-- 中文优先项目的用户可见语义不得被英文默认模板污染。
-- 设计文档只能承载已验证事实，不能承载施工日志或未验证假设。
-- 多语言策略必须显式声明，不能用日志或 stderr 替代用户反馈。

package/templates/knowledge/rules//347/237/245/350/257/206/346/263/250/345/205/245/350/276/271/347/225/214/350/247/204/345/210/231.md

@@ -1,61 +0,0 @@
----
-name: 知识注入边界规则
-scope:
-  - '*'
-products:
-  - '*'
-id: ka-hard-rule-知识注入边界规则
-asset_kind: hard_rule
-lifecycle_status: active
-authority: canonical
-owner_mechanism_id: mc-knowledge-injection-boundary
-routes:
-  - 知识注入边界规则
-primary_triggers:
-  - 知识注入边界规则
-secondary_triggers: []
-negative_triggers: []
-priority: P0
-specificity: 5
-consumes:
-  - mc-intent-router
-hard_blocks:
-  - 注入越权
-  - deprecated被注入
-fallback: manual_required
-required_evidence:
-  - injection_report
-  - consumption_snapshot
-version: 1.0.0
-last_reviewed: '2026-05-22'
-migration_note: 知识资产标准化迁移
-type: hard_rule
-when: 知识注入边界规则
-status: active
----
-
-# 知识注入边界规则
-
-## 核心原则
-
-知识注入必须经过三道门过滤: 状态门、路由门、预算门。未经审核的知识不可进入 prompt。
-
-## 三道门
-
-1. **状态门**: draft/quarantine/deprecated 知识被过滤，不进入 prompt
-2. **路由门**: 知识类型必须匹配当前路由，防止错误注入
-3. **预算门**: budget 不足时优先保留 required，supporting 可被裁剪
-
-## 规则
-
-1. consumption_mode=required 资产缺失时必须报错，不可静默降级
-2. pending_review 知识只能进入 advisory_only，不可进入 injected
-3. 所有注入结果必须生成 KnowledgeInjectionReport
-4. route 不匹配时跳过模板注入，不可强行注入
-
-## 验收标准
-
-- [ ] draft/quarantine 知识不出现在 injected 列表中
-- [ ] required 资产缺失时产生 missing_required_knowledge finding
-- [ ] KnowledgeInjectionReport 包含完整字段
-- [ ] budget 不足时 required 优先于 supporting

package/templates/knowledge/rules//347/237/245/350/257/206/350/265/204/344/272/247/346/262/273/347/220/206/350/247/204/345/210/231.md

@@ -1,61 +0,0 @@
----
-name: knowledge-asset-governance
-when: '知识资产, 模板, pattern, knowledge, template, 同步, 迁移, 审计'
-scope:
-  - governance
-  - knowledge
-  - template
-products:
-  - '*'
-owner_mechanism_id: mc-knowledge-asset-governance
-id: ka-hard-rule-knowledge-asset-governance
-asset_kind: hard_rule
-lifecycle_status: active
-authority: canonical
-routes:
-  - knowledge_index_build
-  - intent_route
-  - intent_expand
-  - template_sync
-primary_triggers:
-  - 知识资产
-  - 模板
-  - 同步
-  - 迁移
-  - 审计
-consumes:
-  - mc-knowledge-injection-boundary
-  - mc-template-sync-contract
-priority: P0
-specificity: 8
-version: 1.0.0
-last_reviewed: '2026-05-22'
-hard_blocks:
-  - 缺frontmatter
-  - 重复canonical
-  - owner缺失
-required_evidence:
-  - KnowledgeAssetAuditReport
-fallback: manual_required
-type: hard_rule
-status: active
----
-
-## 知识资产治理规则
-
-### 资产标准
-1. 所有知识资产必须有 id、asset_kind、lifecycle_status、authority
-2. hard_rule/workflow 必须有 owner_mechanism_id
-3. 同一主题只能有一个 canonical 权威定义
-4. deprecated/quarantine/draft 不得注入 prompt
-
-### 消费链路
-- intent_router 消费 routes/primary_triggers/specificity
-- expander 消费 authority/priority/required_evidence/asset_kind
-- verifier 消费 hard_blocks/fallback/lifecycle_status
-- adapter prompt 消费 name/scope/version
-
-### 禁止
-- 缺必填 frontmatter 字段
-- checklist 平行定义硬规则
-- 静默覆盖用户已修改资产

package/templates/knowledge/rules//347/254/254/344/270/200/346/200/247/345/216/237/347/220/206/346/216/250/347/220/206/350/247/204/345/210/231.md

@@ -1,73 +0,0 @@
----
-name: 第一性原理推理规则
-scope:
-  - '*'
-products:
-  - '*'
-id: ka-hard-rule-第一性原理推理规则
-asset_kind: hard_rule
-lifecycle_status: active
-authority: canonical
-owner_mechanism_id: mc-first-principles
-asset_role: required
-consumed_by:
-  - mc-first-principles
-  - consumable_asset_registry
-  - knowledge_injection
-routes:
-  - 第一性原理推理规则
-primary_triggers:
-  - 第一性原理推理规则
-secondary_triggers:
-  - first principles
-  - 第一性原理
-  - fundamental need
-  - 推理框架
-negative_triggers: []
-priority: P1
-specificity: 5
-consumes:
-  - mc-first-principles
-hard_blocks:
-  - 缺少 fundamental_need
-  - 高影响变更未推理
-  - 关键词替代语义判断
-  - 模板存在触发自动执行
-fallback: manual_required
-required_evidence:
-  - first_principles_frame
-  - reasoning_chain
-version: 1.0.0
-last_reviewed: '2026-05-23'
----
-
-# 第一性原理推理规则
-
-## hard_rules
-
-- 高影响变更必须经过第一性原理推理，推理框架必须包含七个要素：
-  1. 原始目标（fundamental_need）：用户真正想要什么
-  2. 不可变事实（immutable_facts）：不能改变的约束和前提
-  3. 可变假设（mutable_assumptions）：可以挑战和修改的假设
-  4. 约束边界（constraint_boundary）：方案的可行范围
-  5. 推导链（reasoning_chain）：从事实到结论的逻辑推导
-  6. 反例检查（counter_example_check）：方案在什么条件下会失效
-  7. 最小充分方案（minimum_sufficient_solution）：满足目标的最小方案
-- 不得用关键词匹配替代语义判断，必须理解问题的本质。
-- 模板存在不得触发自动执行，必须有推理过程支撑。
-- 修复不得只补表面，必须找到根因。
-
-## not_done_if_missing
-
-- 缺少 fundamental_need → hard fail。
-- 高影响变更未推理 → hard fail。
-- 关键词替代语义判断 → hard fail。
-- 模板存在触发自动执行 → hard fail。
-- 修复只补表面 → hard fail。
-
-## verification_evidence
-
-- `FirstPrinciplesFrame` 包含 fundamental_need、immutable_facts、mutable_assumptions、constraint_boundary、reasoning_chain、counter_example_check、minimum_sufficient_solution 七个字段。
-- `performFirstPrinciplesCheck()` 验证框架完整性。
-- `validateFirstPrinciplesForHighImpact()` 对高影响变更强制推理。
-- `diagnostic_codes`: missing-fundamental-need, high-impact-unframed, keyword-substitution, template-auto-execute。

package/templates/knowledge/rules//347/273/206/350/212/202/347/272/252/345/276/213/350/247/204/345/210/231.md

@@ -1,67 +0,0 @@
----
-name: 细节纪律规则
-scope:
-  - '*'
-products:
-  - '*'
-id: ka-hard-rule-细节纪律规则
-asset_kind: hard_rule
-lifecycle_status: active
-authority: canonical
-owner_mechanism_id: mc-detail-discipline
-asset_role: required
-consumed_by:
-  - mc-detail-discipline
-  - consumable_asset_registry
-  - knowledge_injection
-routes:
-  - 细节纪律规则
-primary_triggers:
-  - 细节纪律规则
-secondary_triggers:
-  - 细节检查
-  - detail discipline
-  - 方案细节
-  - 实施细节
-negative_triggers: []
-priority: P1
-specificity: 5
-consumes:
-  - mc-detail-discipline
-hard_blocks:
-  - 缺失关键维度细节
-  - blocking 检查未接入交付 gate
-  - 细节只有口号无可验证字段
-fallback: manual_required
-required_evidence:
-  - detail_check_report
-  - dimension_coverage
-version: 1.0.0
-last_reviewed: '2026-05-23'
----
-
-# 细节纪律规则
-
-## hard_rules
-
-- 方案细节、实施细节、验收细节、边界例外、反回归检查五个维度必须逐一检查，不得遗漏。
-- 细节必须包含可验证字段或清单（verification checklist），不得只有口号式描述。
-- 阻塞性检查（blocking check）必须接入交付 gate，不得游离在交付流程之外。
-- 设计有方向无边界 → hard fail，必须补齐边界约束。
-- 实施只有快乐路径 → hard fail，必须覆盖失败路径和降级路径。
-- 覆盖/迁移操作无备份回滚 → hard fail。
-
-## not_done_if_missing
-
-- 设计有方向无边界 → hard fail。
-- 实施只有快乐路径 → hard fail。
-- 覆盖/迁移无备份回滚 → hard fail。
-- blocking 检查未接入交付 gate → hard fail。
-- 细节维度缺失（5 个维度任缺 1 个）→ hard fail。
-
-## verification_evidence
-
-- `DetailDisciplineCheck` 包含 dimensions 覆盖报告（方案细节/实施细节/验收细节/边界例外/反回归）。
-- `performDetailCheck()` 返回各维度 pass/fail 状态。
-- `checkDetailGateIntegration()` 验证 blocking 检查已接入交付 gate。
-- `diagnostic_codes`: missing-dimension, gate-not-integrated, no-verification-field。

package/templates/knowledge/rules//350/204/221/346/232/264/344/270/216/346/226/271/346/241/210/346/216/242/347/264/242/350/247/204/345/210/231.md

@@ -1,66 +0,0 @@
----
-name: 脑暴与方案探索规则
-scope:
-  - '*'
-products:
-  - '*'
-id: ka-hard-rule-脑暴与方案探索规则
-asset_kind: hard_rule
-lifecycle_status: active
-authority: canonical
-owner_mechanism_id: mc-brainstorm-contract
-asset_role: required
-consumed_by:
-  - mc-brainstorm-contract
-  - consumable_asset_registry
-  - knowledge_injection
-routes:
-  - 脑暴与方案探索规则
-primary_triggers:
-  - 脑暴与方案探索规则
-secondary_triggers:
-  - brainstorm
-  - 方案探索
-  - 不确定项收敛
-  - option exploration
-negative_triggers: []
-priority: P1
-specificity: 5
-consumes:
-  - mc-brainstorm-contract
-hard_blocks:
-  - 脑暴无候选方案
-  - 脑暴绕过决策主权
-  - 不确定项只报告不收敛
-fallback: manual_required
-required_evidence:
-  - brainstorm_session
-  - option_count
-  - convergence_decision
-version: 1.0.0
-last_reviewed: '2026-05-23'
----
-
-# 脑暴与方案探索规则
-
-## hard_rules
-
-- 不确定项不能只报告，必须给出至少 2 个候选方案并附推荐理由后进入用户确认闭环。
-- 脑暴阶段必须区分四种状态：brainstorm（探索中）→ proposal（有候选）→ decision（选定方案）→ confirmed_decision（用户确认）。
-- 高影响变更不得只有单一无解释路径，必须经过多选项探索。
-- 脑暴推荐不得绕过决策主权机制（mc-decision-sovereignty），推荐结果必须进入 decision 状态确认。
-- 脑暴阶段不得自动执行任何方案，必须等 confirmed_decision 状态。
-
-## not_done_if_missing
-
-- 高影响变更只有单一无解释路径 → hard fail。
-- 脑暴无候选方案直接跳过 → hard fail。
-- 脑暴推荐绕过人工门禁 → hard fail。
-- 不确定项只报告不收敛 → hard fail。
-
-## verification_evidence
-
-- `BrainstormSession` 包含 options 数组（至少 2 项）、recommendation、reasoning 字段。
-- `validateBrainstormSession()` 检查候选数量和收敛状态。
-- `canBrainstormAutoExecute()` 始终返回 false（脑暴不可自动执行）。
-- `diagnostic_codes`: empty-session, auto-execute-blocked, single-option-no-explanation。

package/templates/knowledge/rules//350/256/241/345/210/222/345/211/215/347/275/256/351/227/250/350/247/204/345/210/231.md

@@ -1,59 +0,0 @@
----
-name: plan-proposal-first-gate
-when: '代码修改, 文件编辑, 架构设计, 迁移, 删除, 高风险操作, code_change, file_edit, migration, delete'
-scope:
-  - governance
-  - execution
-  - planning
-products:
-  - '*'
-owner_mechanism_id: mc-plan-proposal-gate
-id: ka-hard-rule-plan-proposal-gate
-asset_kind: hard_rule
-lifecycle_status: active
-authority: canonical
-routes:
-  - code_change
-  - operation
-  - analysis
-  - review
-primary_triggers:
-  - 修改代码
-  - 写文件
-  - 构建
-  - Docker
-  - 迁移
-  - 发布
-  - 删除
-consumes:
-  - mc-intent-router
-  - mc-task-context-lifecycle
-priority: P0
-specificity: 9
-version: 1.0.0
-last_reviewed: '2026-05-22'
-hard_blocks:
-  - 缺计划写入
-  - 高风险无确认
-required_evidence:
-  - plan_proposal_evidence
-fallback: manual_required
-type: hard_rule
-status: active
----
-
-## 计划前置门规则
-
-### 核心原则
-先说明计划，再执行动作。任务越复杂、风险越高，计划越完整。
-
-### 执行前必须
-1. 给出与任务风险匹配的计划或方案
-2. 高风险动作必须用户确认
-3. 计划必须记录验证方式和风险
-
-### 禁止
-- 无计划直接写文件、改代码、构建、Docker、迁移、发布
-- none_with_reason 用于写入或高风险任务
-- 执行动作超出已确认计划 scope
-- review 上下文擅自修复

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

@@ -1,71 +0,0 @@
----
-name: 设计产物包规则
-id: ka-rule-design-artifact-pack
-asset_kind: hard_rule
-lifecycle_status: active
-authority: canonical
-scope:
-  - all
-products:
-  - '*'
-routes:
-  - artifact_generation
-  - code_change
-primary_triggers:
-  - 架构设计文档
-  - 数据库设计文档
-  - API接口规格文档
-priority: P0
-specificity: 5
-version: 1.0.0
-last_reviewed: '2026-05-25'
-owner_mechanism_id: mc-design-artifact-pack
-hard_blocks:
-  - 未经复验的设计文档支撑编码或交付
-  - API 缺字段级契约
-  - 数据库 SQL 不可执行
-  - 跨设计产物关键冲突
-required_evidence:
-  - design_artifact_pack
-  - consistency_verification
-consumes:
-  - architecture_decision_workshop
-  - docs/architecture/00-架构决策记录.md
-  - docs/architecture/01-架构设计文档.md
-fallback: manual_required
-type: rule
-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 示例不能替代字段表。
-- SQL、OpenAPI、架构、数据库和 API 文档出现关键漂移时必须阻断。
-- 旧文档在新标准下必须先审计；未经确认和复验不得继续作为编码依据。
-- 升级必须默认 dry-run，确认写入时归档原文件和 hash。