soloforge 1.1.46 → 1.1.48

package/templates/design//344/273/273/345/212/241/346/213/206/350/247/243.md

@@ -1,61 +0,0 @@
----
-id: ka-procedure-任务拆解流程
-kind: guidance
-title: 任务拆解
-sync_policy: copy_to_project
-status: active
-triggers:
-  - 任务拆解
-  - 工作分解
-  - task breakdown
-  - 任务拆分
-  - design
-  - 工单
-  - 工作拆分
-extra:
-  name: task-breakdown
-  type: procedure
-  scope:
-    - backend
-    - frontend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.2.0
-  last_reviewed: '2026-06-04'
-  domain: design
-  verification_layer: L2
-  stage: design
-  owner_mechanism: mc-intent-expander
----
-
-## 适用场景
-将设计产物转化为可执行的任务卡片，包含明确范围、验收标准和测试映射。适用于编码前的任务规划阶段。
-
-## 步骤
-1. 确定工单模式：skip（跳过）/ mini（简化）/ full（完整），基于变更类型和风险等级
-2. 先产出交付蓝图：目标、冲突、推荐方案、确认状态、验收标准、3 轮重试策略
-   - **选择分解策略**：
-     - sequential：串行依赖链（A→B→C）——适用强依赖场景
-     - parallel：并行扇出（A→[B,C,D]）——适用独立模块
-     - hierarchical：分层递归（A→[B→[C,D], E]）——适用复杂嵌套
-     - 策略写入切片计划「分解策略」字段
-3. 生成任务卡片：每张卡有明确成功标准、上游引用、验收映射和测试映射
-4. DDL 独立为前置任务；多服务按服务拆分；单接口/页面可合并为一张可验证卡
-5. 控制实现上下文：必须读/可选读/默认不读列表，引用上游路径而非复制全文
-6. 验证可追溯性：每张任务卡追溯到需求、接口和设计锚点
-7. **生成依赖图**：基于任务卡片依赖声明生成分组依赖图（同组 parallel/跨组 sequential/regression_blocking 标注）
-
-## 检查点
-- [ ] 工单模式匹配风险等级和变更类型
-- [ ] 每张任务卡有可验证的成功标准（非"让它工作"）
-- [ ] 任务卡追溯到需求和设计锚点，无孤立任务
-- [ ] DDL 独立为前置任务
-- [ ] 外部系统/大表 DDL/数据迁移/权限安全标记为高风险
-- [ ] 分解策略已声明（sequential/parallel/hierarchical）
-
-## 注意事项
-- 禁止复制上游全文到工单中（引用路径）
-- 禁止只拆后端不拆前端和集成
-- 禁止模糊成功标准如"功能正常"
-- 自动修复循环上限 3 轮

package/templates/design//344/273/273/345/212/241/350/247/204/345/210/222.md

@@ -1,84 +0,0 @@
----
-id: ka-procedure-任务规划工作流
-kind: guidance
-title: 任务规划
-sync_policy: copy_to_project
-status: active
-triggers:
-  - 任务规划工作流
-  - 老系统任务规划
-  - 切片缓冲规划
-  - 清洗脚本产出
-  - 任务规划流程
-extra:
-  name: task-planning-workflow
-  type: procedure
-  scope:
-    - '*'
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.0.0
-  last_reviewed: '2026-06-04'
-  domain: design
-  verification_layer: L2
-  stage: design
-  owner_mechanism: mc-existing-system-artifact
----
-
-# 任务规划工作流（老系统专属）
-
-> 适用范围：老系统任务规划环节（design 域产物 → build 域执行）
-> 输入：详细设计文档 + 一键开关配置 + 回滚手册 + 改造影响范围评估
-> 输出：带缓冲切片计划 + 历史数据清洗脚本
-
-## 步骤 1：读取阶段输入
-
-1. 读取详细设计文档
-2. 读取一键开关配置
-3. 读取紧急回滚手册
-4. 读取改造影响范围评估
-5. **检查点**：所有输入产物存在且可读
-6. 在切片计划 §1.5 阶段输入声明中，逐项标注 ☑ 已读取
-
-## 步骤 2：按切片规划规则拆分切片
-
-1. 使用 shared 切片规划规则（与新系统相同）
-2. 产出切片列表，每个切片标注：DD-* 编号、模块、影响范围
-3. **检查点**：每个切片均有 DD-* 或 ARCH-* 上游引用
-
-## 步骤 3：计算排查缓冲（老系统专属）
-
-1. 对每个切片按特征匹配缓冲比例（见切片计划 §3 判定标准）
-2. 产出结构化缓冲表格（见切片计划 §2 排查缓冲字段）
-3. **检查点**：涉及 DB 迁移的切片缓冲 ≥ 35%
-
-## 步骤 4：产出历史数据清洗脚本
-
-1. 识别涉及数据迁移的切片（缓冲比例 ≥ 35%）
-2. 按清洗脚本模版产出：清洗 SQL + 备份 SQL + 回滚 SQL
-3. 在切片计划 §5 中建立脚本与切片的关联
-4. **检查点**：涉及 DB 迁移的切片均有对应清洗脚本
-
-## 步骤 5：自检
-
-1. 切片与详细设计 DD-* 编号对齐
-2. 排查缓冲表格每项活动有预估时间
-3. 阶段输入声明中所有产物已标注"已读取"
-4. §5 中涉及 DB 迁移的切片均有清洗脚本关联
-
-## 步骤 6：design-gate 校验
-
-1. 运行 design-gate（域级检查）
-2. 通过 → 进入编码阶段
-3. 失败 → 返回对应步骤修正
-
-### 失败回退映射
-
-| gate 检查失败项 | 回退步骤 |
-|---------------|---------|
-| 切片计划完备 | 步骤 2 |
-| 切片与接口/数据库一致性 | 步骤 2 |
-| 排查缓冲完整性（老系统） | 步骤 3 |
-| 阶段输入声明完整性（老系统） | 步骤 1 |
-| 清洗脚本关联完整性（老系统） | 步骤 4 |

package/templates/design//344/274/232/350/257/235/346/201/242/345/244/215-procedures.md

@@ -1,78 +0,0 @@
----
-id: ka-procedure-会话恢复流程
-kind: guidance
-title: 会话恢复
-sync_policy: copy_to_project
-status: active
-triggers:
-  - operate
-  - 恢复
-  - resume
-  - 继续开发
-extra:
-  name: session-resume
-  type: procedure
-  scope:
-    - backend
-    - frontend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  domain:
-    - build
-    - design
-    - verify
-  verification_layer: L2
-  stage: design
-  owner_mechanism: mc-session-recovery
----
-
-# 会话恢复流程
-
-## 目的
-
-确保每次 AI 编码会话启动时，能够正确恢复历史上下文，避免重复工作和信息丢失。
-
-## 前置条件
-
-- 工作区已初始化（.soloforge/ 目录存在）
-- 有历史任务上下文（tasks/ 目录非空）
-
-## 步骤
-
-### 步骤 1: 检查工作区状态
-
-1. 通过 `resolveProjectConfig()` 恢复项目配置（优先读取 intent.yaml，回退到项目文件探测）
-2. 检查 `tasks/` 目录中是否存在未完成的任务
-3. 检查 git 工作区是否有未提交的变更
-
-### 步骤 2: 恢复任务上下文
-
-1. 调用 `sf_task action=query` 获取当前任务状态
-2. 对每个未完成任务，读取其上下文（阶段、变更文件、验证结果）
-3. 汇总恢复报告：哪些任务在进行中、哪些被阻断、阻断原因
-
-### 步骤 3: 确认恢复策略
-
-- **无历史任务**：正常启动新会话
-- **有进行中任务**：向用户确认是否继续上次任务
-- **有被阻断任务**：向用户展示阻断原因，确认恢复路径
-
-### 步骤 4: 执行恢复
-
-1. 按用户确认的恢复策略，恢复任务上下文到工作区
-2. 重新加载知识库注入（确保机制规则与当前阶段匹配）
-3. 进入对应的阶段流程继续执行
-
-## 输出
-
-- 恢复报告（恢复了哪些任务、当前阶段、下一步操作）
-- 或新会话就绪确认
-
-## 异常处理
-
-- 配置文件损坏 → 提示用户修复后重试
-- 任务上下文不一致 → 建议用户使用 `sf_task action=query（归档陈旧任务）` 清理陈旧任务
-- Git 工作区冲突 → 提示用户手动解决后再恢复

package/templates/design//345/205/274/345/256/271/346/200/247/346/243/200/346/237/245.md

@@ -1,89 +0,0 @@
----
-id: 兼容性检查
-kind: guidance
-title: 兼容性检查
-triggers:
-  - 兼容性
-  - 向后兼容
-  - 版本兼容
-sync_policy: copy_to_project
-status: active
-extra:
-  name: compatibility-check
-  type: constraint
-  scope:
-    - '*'
-  domain: design
-  lifecycle_status: active
-  verification_layer: L2
-  stage: design
-  owner_mechanism: mc-existing-system-review
----
-
-# 向后兼容性检查规则
-
-## COMP-01: 字段删除过渡期
-  severity: error
-  check_type: deterministic
-  check_hint: 字段删除须有过渡期 ≥2 版本
-  evidence_required: "数据库变更方案 §2"
-
-## COMP-02: API 版本化
-  severity: error
-  check_type: deterministic
-  check_hint: API 破坏性变更须版本化（v1→v2）
-  evidence_required: "接口对接方案 §4"
-
-## COMP-03: 新增必填字段默认值
-  severity: warning
-  check_type: deterministic
-  check_hint: 新增必填字段须有默认值
-  evidence_required: "数据库变更方案 §4"
-
-## COMP-04: 枚举值向后兼容
-  severity: warning
-  check_type: deterministic
-  check_hint: 枚举值变更须向后兼容
-  evidence_required: "数据库变更方案 §2"
-
-## COMP-05: 外键数据完整性
-  severity: warning
-  check_type: deterministic
-  check_hint: 外键变更须评估数据完整性
-  evidence_required: "数据库变更方案 §3"
-
-## COMP-06: 老系统行为不变量
-  severity: info
-  check_type: semantic
-  check_hint: 老系统行为不变量未被破坏
-  evidence_required: "改造影响评估 §2.5"
-
-## COMP-07: 老系统 API 调用方不受影响
-  severity: error
-  check_type: deterministic
-  check_hint: 老系统 API 调用方不受影响
-  evidence_required: "隔离适配器方案 §2.4"
-
-## COMP-08: 配置项迁移脚本
-  severity: warning
-  check_type: deterministic
-  check_hint: 配置项变更须有迁移脚本
-  evidence_required: "配置迁移清单"
-
-## COMP-09: 定时任务安全
-  severity: warning
-  check_type: deterministic
-  check_hint: 定时任务变更不影响正在执行的实例
-  evidence_required: "部署方案 §5"
-
-## COMP-10: 数据迁移语义一致
-  severity: info
-  check_type: semantic
-  check_hint: 数据迁移后业务语义一致
-  evidence_required: "数据库变更方案 §4"
-
-## COMP-11: 跨阶段检查一致性
-  severity: warning
-  check_type: deterministic
-  check_hint: 跨架构/详细设计/编码阶段检查一致性
-  evidence_required: "设计一致性验收报告（audits/01-设计一致性验收报告.md）"

package/templates/design//345/210/207/347/211/207/350/256/241/345/210/222.md

@@ -1,149 +0,0 @@
----
-id: 切片计划
-kind: artifact
-title: 切片计划
-sync_policy: copy_to_project
-status: active
-extra:
-  name: slice-plan
-  type: artifact
-  scope:
-    - '*'
-  domain: design
-  lifecycle_status: active
-  stage: design
-  owner_mechanism: mc-generic-artifact
----
-
-# 开发任务切片计划
-
-## 1. 项目信息
-- 项目名称：<!-- 名称 -->
-- 系统类型：新系统/老系统
-- 创建时间：<!-- 日期 -->
-- 架构设计路径：docs/architecture/01-架构设计文档.md
-- 详细设计路径：docs/design/03-详细设计文档.md
-- 数据库设计路径：docs/design/01-数据库设计文档.md
-- API 规格路径：docs/design/02-API接口规格文档.md
-
-> **根本目标引用**：本产物的 `fundamental_need` 见需求分析文档 §1.3。若未声明，引用审查规则 FP-01。
-
-### 1.5 阶段输入（老系统）
-
-| 输入产物 | 来源阶段 | 路径 | 检查 |
-|---------|---------|------|------|
-| 一键开关配置 | 阶段 4（详细设计） | <!-- 路径 --> | □ 已读取 |
-| 紧急回滚手册 | 阶段 4（详细设计） | <!-- 路径 --> | □ 已读取 |
-| 改造影响范围评估 | 阶段 3（架构设计） | <!-- 路径 --> | □ 已读取 |
-
-## 2. 切片列表
-
-### SLC-{模块}-01: <!-- 切片名称 -->
-- **优先级：** 1
-- **描述：** <!-- 功能描述 -->
-- **分解策略：** sequential | parallel | hierarchical（sequential: 串行依赖链 A→B→C；parallel: 并行扇出 A→[B,C,D]；hierarchical: 分层递归 A→[B→[C,D], E]）
-- **测试策略：** test_first | verification_first | manual_acceptance（test_first: 严格红绿重构；verification_first: 先写验证用例再实现；manual_acceptance: 手工验收确认）
-- **上游引用：** DD-A*/DD-T*（必须填真实编号如 `DD-A01`/`DD-T01`，供 cross_validation 校验与 API规格/数据库设计文档一致；占位 `DD-*` 不算）
-- **涉及文件：**
-  - must_read: <!-- 必须读取的文件路径 -->
-  - optional_read: <!-- 可选读取的文件路径 -->
-  - default_skip: <!-- 默认跳过的文件路径 -->
-- **影响范围：** <!-- 本切片变更可能影响的模块/接口列表 -->
-- **依赖：** 无 / 依赖 SLC-{模块}-{序号}
-- **排查缓冲（老系统适用）：**
-
-      | 缓冲活动 | 预估时间 | 说明 |
-      |---------|---------|------|
-      | 隐式约束探索 | <!-- 如 30 分钟 --> | 探测该切片涉及模块的隐式约定和未文档化假设 |
-      | 兼容性验证 | <!-- 如 30 分钟 --> | 开关关闭时新老逻辑比对 |
-      | 回退测试 | <!-- 如 20 分钟 --> | 验证一键开关可正常切回 |
-      | 新老逻辑比对 | <!-- 如 15 分钟 --> | 执行新老逻辑比对日志模版 |
-      | **总缓冲** | <!-- 合计 --> | — |
-- **测试状态：** pending → red → green → refactored
-- **验收契约（acceptance_contract）：**
-  - **可独立验证：** <!-- 填 是 或 否；选否时声明依赖切片 SLC-... -->
-  - **验收范围：** <!-- 列具体 REQ-NNN，禁止"全部/所有"通配 -->
-  - **部署要求：** <!-- 后端:是/否+端口；前端:是/否+端口 -->
-  - **E2E 验证项：** <!-- 浏览器操作步骤 + 预期结果，≥1 项 -->
-- **验收标准：**
-  - [AC-SLC-{模块}-01-01] <!-- 功能验收：核心功能点的预期行为 -->
-  - [AC-SLC-{模块}-01-02] <!-- 质量验收：测试覆盖率、无 lint 错误 -->
-  - [AC-SLC-{模块}-01-03] <!-- 边界验收：边界条件和错误处理 -->
-
-<!-- 按优先级列出所有切片 -->
-
-## 3. 执行顺序与缓冲安排
-
-### 3.1 执行分组
-
-| 组 | 切片 | 模式 | 前置组 |
-|---|------|------|--------|
-| G1 | SLC-{模块}-01, SLC-{模块}-02 | parallel | — |
-| G2 | SLC-{模块}-03 | sequential | G1 |
-| G3 | SLC-{模块}-04 | parallel | G2 |
-
-### 3.2 依赖关系图
-
-```text
-SLC-{模块}-01 ──→ SLC-{模块}-03 ──→ SLC-{模块}-04
-SLC-{模块}-02 ──↗
-```
-
-### 3.3 缓冲安排
-
-| 切片特征 | 缓冲比例 | 缓冲活动要求 |
-|---------|---------|-------------|
-| 纯新增模块 | 0% | 无老系统交互，无需额外缓冲 |
-| 新增接口 + 老系统调用 | 15% | 须包含兼容性验证 + 回退测试 |
-| 改造老系统模块 | 25% | 须包含隐式约束探索 + 兼容性验证 + 回退测试 |
-| 涉及数据库迁移 | 35% | 须包含清洗脚本验证 + 回滚脚本测试 + 数据一致性校验 |
-| 涉及核心业务逻辑 | 40% | 须包含完整新老逻辑比对 + 回退测试 + 隐式约束探索 |
-
-> 老系统切片预留 0.5~1 时间窗口用于排查缓冲活动。
-
-## 4. 风险标注
-
-### 4.1 风险矩阵
-
-| 切片 | 风险等级 | 影响范围 | 回归阻断 |
-|------|---------|---------|---------|
-| SLC-{模块}-01 | 高/中/低 | <!-- 涉及模块/接口 --> | 是/否 |
-| SLC-{模块}-02 | 高/中/低 | <!-- 涉及模块/接口 --> | 是/否 |
-
-### 4.2 回归预防
-- 跨组切片标记 `regression_blocking`，须串行执行
-- 高风险切片须安排独立审查确认变更安全性
-- 涉及数据库迁移、跨模块接口变更、老系统核心逻辑修改等判定为高风险
-
-## 5. 历史数据清洗脚本（老系统适用）
-
-> 按历史数据清洗脚本模版（existing-system）产出。
-> 产出时机：任务规划阶段（阶段 5），而非联调阶段。
-
-| 脚本 | 涉及表 | 执行时机 | 关联切片 | 验证标准 | 回滚方案 |
-|------|--------|---------|---------|---------|---------|
-| <!-- 脚本路径 --> | <!-- 表名 --> | 联调前 | SLC-{模块}-{序号} | 影响行数 ±5% | <!-- 回滚 SQL 路径 --> |
-
-## 6. 文件汇总
-
-| 文件路径 | 涉及切片 | 变更类型 | 上下文边界 |
-|---------|---------|---------|-----------|
-| <!-- src/... --> | SLC-{模块}-01 | 新增/修改/删除 | must_read/optional_read/default_skip |
-
-## 7. 动态重规划
-
-### 7.1 触发条件
-- 切片执行偏差：实际涉及文件超出计划 ≥3 个
-- 测试持续红：同一切片测试失败 ≥3 轮未通过
-- 依赖切片失败：前置切片回归阻断标记触发
-- 未覆盖设计场景：编码中发现设计文档未覆盖的业务场景
-
-### 7.2 重规划策略
-- **局部重规划**：偏差≤2 文件，调整涉及文件列表 + 追加测试，继续执行
-- **结构重规划**：偏差>2 文件或影响其他切片，回退到任务拆解流程（E-01）
-- **回退**：涉及架构级变更，回退到 design 域（架构设计）重新评估
-
-### 7.3 偏差容忍度
-- 涉及文件≤2：允许局部调整，更新切片计划
-- 验收标准不降级：AC 数量不得减少，覆盖维度不得缩窄
-- 时间超 2x：触发重规划评估，决定局部/结构/回退

package/templates/design//345/211/215/347/253/257/346/200/247/350/203/275.md

@@ -1,49 +0,0 @@
----
-id: ka-pattern-frontend-performance
-kind: knowledge
-title: 前端性能
-sync_policy: copy_to_project
-status: active
-extra:
-  name: frontend-performance
-  scope:
-    - frontend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: knowledge
-  domain:
-    - build
-    - design
-  verification_layer: L2
-  stage: design
-  owner_mechanism: mc-frontend-pattern
----
-
-## 决策规则
-- 路由级别必须使用懒加载（React.lazy / dynamic import），禁止首屏加载所有页面代码
-- 大型第三方库（图表、富文本编辑器）必须按需加载，禁止全量引入
-- 图片必须使用懒加载（Intersection Observer 或 loading="lazy"），大图必须压缩和适配分辨率
-- 列表数据超过 100 条必须使用虚拟滚动（react-window / react-virtualized）
-- 组件卸载时必须清理副作用（定时器、WebSocket、事件监听），防止内存泄漏
-- useEffect 依赖数组必须准确，禁止无依赖导致每次渲染执行
-- 重复渲染必须用 React.memo / useMemo / useCallback 优化，但禁止过度优化（简单组件不需要 memo）
-- 首屏关键资源必须预加载，非关键资源延迟加载
-- 首屏加载时间必须 ≤ 3s（Fast 3G），超过时必须优化（懒加载、代码分割、CDN）
-- 列表渲染超过 100 行必须使用虚拟滚动（react-window / vue-virtual-scroller）
-- 组件重渲染必须有明确优化（React.memo / useMemo / shouldComponentUpdate）
-- 图片资源必须使用 WebP 格式 + CDN 加速 + 懒加载
-- 生产构建必须开启 Tree Shaking + Code Splitting + Gzip 压缩
-
-## 验收项
-- [AC-01] 路由级别懒加载
-- [AC-02] 大型库按需引入
-- [AC-03] 组件卸载清理副作用
-- [AC-04] useEffect 依赖准确无冗余执行
-- [AC-05] 长列表使用虚拟滚动
-- [AC-06] 首屏 ≤ 3s
-- [AC-07] 长列表虚拟滚动
-- [AC-08] 图片 WebP + CDN + 懒加载
-- [AC-09] 生产构建优化开启

package/templates/design//345/216/206/345/217/262/351/201/227/347/225/231/351/233/267/345/214/272/346/270/205/345/215/225.md

@@ -1,50 +0,0 @@
----
-id: 历史遗留雷区清单
-kind: artifact
-title: 历史遗留雷区清单
-sync_policy: copy_to_project
-status: active
-extra:
-  name: legacy-minefield-checklist
-  type: artifact
-  scope:
-    - '*'
-  domain: design
-  lifecycle_status: active
-  stage: design
-  owner_mechanism: mc-existing-system-artifact
----
-
-# 历史遗留雷区清单
-
-## 1. 扫描范围
-- 扫描时间：<!-- 日期 -->
-- 扫描工具：<!-- 工具/人工 -->
-
-## 2. 雷区列表
-
-| # | 类型 | 严重程度 | 位置 | 描述 | 影响范围 |
-|---|---|---|---|---|---|
-| 1 | 数据库/代码/架构 | 高/中/低 | <!-- 文件:行号或模块 --> | <!-- 描述 --> | <!-- 影响的接口/服务 --> |
-
-## 3. 反模式分类（与规则对齐）
-
-> 分类标准与 `雷区反模式.md` 规则一致，按数据库/代码/架构三维度组织。
-
-### 数据库层面
-- 无索引大表（>10 万行）
-- 循环查库（N+1）
-- 全表扫描
-- 缺少事务
-
-### 代码层面
-- 硬编码配置/密钥
-- 大函数/大类（>100 行 / >1000 行）
-- 循环调用外部接口
-- 吞异常
-
-### 架构层面
-- 循环依赖
-- 共享数据库
-- 缺少降级
-- 同步阻塞

package/templates/design//345/216/237/345/236/213/346/272/220/347/240/201/346/217/220/345/217/226.md

@@ -1,78 +0,0 @@
----
-id: 原型源码提取
-kind: guidance
-title: 原型源码提取
-sync_policy: copy_to_project
-status: active
-triggers:
-  - 原型提取
-  - 源码分析
-  - source extraction
-  - prototype source
-extra:
-  name: prototype-source-extraction
-  type: constraint
-  domain: design
-  lifecycle_status: active
-  scope:
-    - backend
-    - frontend
-  products:
-    - '*'
-  verification_layer: L2
-  stage: design
-  owner_mechanism: mc-command-router
----
-
-# 原型源码提取规则
-
-## 必须读取的源码材料
-
-需求分析阶段，必须从以下路径模式读取源码材料：
-
-1. `src/**/*Controller.ts` — 控制器层，提取路由定义和请求处理逻辑
-2. `src/**/*Service.ts` — 服务层，提取业务规则和流程编排
-3. `src/**/*Repository.ts` / `src/**/*Dao.ts` — 数据访问层，提取数据模型和查询逻辑
-4. `src/**/*Model.ts` / `src/**/*Entity.ts` — 实体定义，提取字段和约束
-5. `src/**/*Config.ts` / `config/**/*` — 配置文件，提取环境依赖和参数
-6. `src/**/*Middleware.ts` — 中间件，提取横切关注点（认证、日志等）
-7. `src/pages/**/*` / `src/views/**/*` / `app/**/page.tsx` — 页面组件，提取路由和页面结构
-8. `src/components/**/*` — UI 组件，提取组件树和 props
-9. `src/stores/**/*` / `src/state/**/*` — 状态管理，提取数据流和状态转换
-10. `src/styles/**/*` / `src/tokens.*` / `tailwind.config.*` — 设计令牌，提取色彩/间距/字体
-11. `src/api/**/*` / `src/services/**/*` — API 客户端，提取接口调用和数据绑定
-12. `src/i18n/**/*` / `src/locales/**/*` — 国际化文件，提取文案和术语
-
-### 可选设计资源路径
-
-> SoloForge 核心场景是从源码提取。以下路径为可选，但一旦存在必须标注引用。
-
-13. `design/**/*` / `figma-export/**/*` / `prototype-export/**/*` — 设计稿导出文件
-14. `*.figma` / `*.sketch` — 原始设计文件路径（仅标注，不直接读取）
-15. `docs/design/**/*` / `docs/architecture/**/*` / `docs/analyze/**/*` — 设计文档（数据库/API/详细/架构/原型说明）
-
-### 接口与数据规格路径
-
-16. `openapi.*` / `swagger.*` / `api-docs/**/*` — API 规格文件
-17. `prisma/schema.prisma` / `drizzle/schema.ts` / `knexfile.*` — ORM schema
-18. `migrations/**/*` / `db/migrate/**/*` — 数据库迁移文件
-
-## 禁止来源
-
-以下来源不得作为需求分析的源码材料依据：
-
-1. 禁止仅凭口头描述编写需求，必须有源码证据支撑
-2. 禁止从 `node_modules/` 或第三方库源码推断需求
-3. 禁止使用 `dist/` 或编译产物代替源码
-4. 禁止从测试文件反推需求规格（测试用于验证，不用于定义）
-
-## 证据标记规范
-
-每个提取的需求点必须标注来源证据：
-
-- `[SRC:文件路径:行号]` — 直接从源码提取
-- `[LOG:日志片段]` — 从运行日志推导（需标注日志来源）
-- `[CFG:配置项]` — 从配置文件提取
-- `[REF:引用链路]` — 从调用链路推导（需标注链路起点和终点）
-- `[DES:设计资源路径]` — 设计稿提取（需人工确认）
-- `[INF:推理结论]` — AI 推理（低置信，必须标注推理依据，须人工确认才可进入基线）