soloforge 1.1.42 → 1.1.44

package/templates/design//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

@@ -0,0 +1,116 @@
+---
+id: ka-procedure-全生命周期工作流导航
+kind: guidance
+title: 全生命周期工作流导航
+sync_policy: internal
+status: active
+triggers:
+  - 下一步
+  - 继续
+  - 现在能写代码吗
+  - 工作流导航
+  - navigation
+  - 阶段判断
+  - 工作包生成
+extra:
+  name: full-lifecycle-navigation
+  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-workflow-navigation-contract
+---
+
+# 全生命周期工作流导航
+
+本流程定义了从项目初始化到发布后的完整工作流导航决策树。
+
+## 项目生命周期阶段
+
+| 阶段 | 判断条件 | 下一步 |
+|------|----------|--------|
+| 未初始化 | .soloforge/ 不存在或无 intent.yaml | 运行 soloforge init |
+| 配置不完整 | resolveConfig 返回 missing 字段 | 通过 编辑 `intent.yaml` 补充不可探测偏好（产品类型、交付设置等）；技术栈和构建命令由项目文件自动探测 |
+| 知识就绪 | 配置完整（tech_stack + build_commands 已就绪）、知识库已索引 | 提交开发意图开始新任务 |
+| 设计进行中 | 设计产物存在但未通过审计 | 完成设计并通过审计 |
+| 实现就绪 | 设计产物已通过审计 | 制定开发切片计划 |
+| 开发进行中 | 有任务在编码/验证阶段 | 继续编码和验证 |
+| 交付就绪 | 任务已通过验证 | 进行交付验收 |
+| 已发布 | 已交付上线 | 进入观察期 |
+| 发布后观察 | 发布后验证阶段 | 监控、反馈、回滚预案 |
+
+## 任务生命周期阶段
+
+任务从分类到交付的完整流程：
+
+1. 输入材料收集 → 2. 需求明确化 → 3. 决策研讨 → 4. 架构设计 → 5. 详细设计 → 6. 数据库设计 → 7. API 设计 → 8. 切片规划 → 9. 编码实现 → 10. 本地验证 → 11. 测试 → 12. 代码审查 → 13. 修复复验 → 14. 交付验收 → 15. 发布准备 → 16. 发布后观察
+
+## 导航决策流程
+
+1. 调用 `sf_task action=query` 或 `sf_task action=query` 获取当前状态
+2. 检查配置完整性：resolveConfig 返回 missing 时，优先补充不可探测字段
+3. 检查是否有陈旧任务需要处理
+4. 读取 `confirmation_decisions`
+   - `must_confirm` 非空时，先让用户选择，不得继续执行会被阻断的动作
+   - `should_confirm` 非空时，明确说明建议确认的收益，但允许继续只读或低风险准备
+   - `auto_resolvable` 非空时，按推荐命令修复或复验，不把它伪装成业务确认
+4. 读取返回的 work_package，按描述执行下一步
+5. 遵守 disallowed_actions 中的禁止动作
+6. 执行完成后运行 acceptance_commands 验证
+7. 如需用户确认，必须列出具体确认项、选项和不确认影响，不能笼统说“需要确认”
+
+## 空项目确认口径
+
+从 0 开发的新项目没有既有项目事实可确认。导航只能要求用户确认目标、边界、技术选择和默认口径。
+
+- 可以继续：初始化、模版同步、知识索引、只读规划、设计准备
+- 不可声称：自动推断结果是已有系统事实
+- 不可阻塞：因为没有源码或历史文档而阻止空项目建立基线
+- 必须阻塞：用户需要在多个业务口径或高影响决策中做选择但尚未选择
+
+## 陈旧任务处理
+
+当 current-task.json 指向旧任务时：
+- 选择"恢复"：继续旧任务从上次中断处开始
+- 选择"归档"：将旧任务标记为归档，清理指针
+- 选择"新建"：归档旧任务后开始新任务
+- 不得绕过 SoloForge 直接操作
+- 归档只处理陈旧指针，不是直接写业务代码的许可
+
+## 阻断恢复
+
+当 Edit、Write、Bash 或 MCP 工具被 SoloForge 阻断时：
+
+- 先读取阻断输出中的 `recovery_command`、`template_path` 和 `confirmation_decisions`
+- 配置不完整时，按 编辑 `intent.yaml` 补充缺失字段后重试
+- 自动修复项按命令修复后重试对应工具
+- 业务确认项列出具体必须确认内容后等待用户确认
+- 不得取消任务后直接写代码
+- 不得改用 Bash 绕过受控任务或设计复验
+- 不得手动删除 `.soloforge/state`
+- 若确认为陈旧任务，必须通过 `sf_task action=archive_stale confirm=true` 或导航推荐命令归档，归档后仍必须重新 `sf_task -> sf_work`
+
+## 常见导航场景
+
+**场景: 用户说"继续"**
+→ 调用 sf_task action=query 获取 work_package，按描述执行
+
+**场景: 用户说"现在能写代码吗"**
+→ sf_task action=query 检查项目阶段和设计审计状态，返回允许或阻断原因
+
+**场景: 用户说"审查后做什么"**
+→ sf_task action=query 检查 code_review 结果，推荐下一步验证或交付
+
+**场景: 用户说"发布后做什么"**
+→ sf_task action=query 返回发布后观察工作包：验证、监控、反馈收集

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

@@ -0,0 +1,89 @@
+---
+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/247/204/345/210/222.md

@@ -0,0 +1,76 @@
+---
+id: 切片规划
+kind: guidance
+title: 切片规划
+sync_policy: copy_to_project
+status: active
+triggers:
+  - 切片规划
+  - 切片计划
+  - slice planning
+  - 任务拆分
+  - 功能拆分
+extra:
+  name: slice-planning
+  type: constraint
+  domain: design
+  lifecycle_status: active
+  scope:
+    - backend
+    - frontend
+  products:
+    - '*'
+  verification_layer: L2
+  stage: design
+  owner_mechanism: mc-command-router
+---
+
+# 切片规划规则
+
+## SLP-01: 最小闭环
+  id: SLP-01
+  name: 最小闭环
+  severity: error
+  check_type: semantic
+  check_hint: 切片 AC 不得引用其他切片的输出作为前置条件
+  description: 每个切片必须能独立完成并验证，不依赖后续切片的产出。AC 中引用的输入必须是上游设计产物（DD-*/ARCH-*），而非同层级其他切片的输出。
+
+## SLP-02: 可独立测试
+  id: SLP-02
+  name: 可独立测试
+  severity: error
+  check_type: semantic
+  check_hint: 每个切片的测试文件可独立执行，不需要等待其他切片完成
+  description: 切片完成后必须能独立运行测试验证。若需其他切片的数据，须通过 fixture/mock 提供，不得依赖真实执行顺序。
+
+## SLP-03: 单一职责
+  id: SLP-03
+  name: 单一职责
+  severity: warning
+  check_type: semantic
+  check_hint: 切片描述≤2 个功能点
+  description: 每个切片只聚焦一个功能点或一个变更维度。描述超过 2 个功能点的切片应拆分。复合切片须用前置依赖字段关联。
+
+## SLP-04: 上游引用完备
+  id: SLP-04
+  name: 上游引用完备
+  severity: error
+  check_type: deterministic
+  check_hint: 每个切片的上游引用字段包含 DD-* 和 ARCH-* 编号
+  description: 每个切片必须引用详细设计文档中的 DD-* 编号（接口/模块）和架构设计文档中的 ARCH-* 编号（架构决策）。无上游设计引用的切片不得进入执行阶段。
+
+## SLP-05: 验收标准三路径
+  id: SLP-05
+  name: 验收标准三路径
+  severity: error
+  check_type: deterministic
+  check_hint: 每个切片≥3 条 AC，覆盖功能/质量/边界三路径
+  description: 每个切片必须有 AC-* 验收标准，至少包含：功能验收（核心功能点的预期行为）、质量验收（测试覆盖率、无 lint 错误）、边界验收（边界条件和错误处理）。
+
+## SLP-06: ID 命名规范
+  id: SLP-06
+  name: ID 命名规范
+  severity: error
+  check_type: deterministic
+  check_hint: 切片 ID 格式 SLC-{模块简称}-{序号}，AC ID 格式 AC-SLC-{模块}-{序号}-{N}
+  description: 任务 ID 格式：`SLC-{模块简称}-{序号}`（如 SLC-Auth-01）。验收标准 ID 格式：`AC-{任务ID}-{序号}`（如 AC-SLC-Auth-01-01）。依赖声明使用任务 ID，不允许使用描述性文字。ID 不得重复或缺失。

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

@@ -0,0 +1,149 @@
+---
+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

@@ -0,0 +1,49 @@
+---
+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

@@ -0,0 +1,50 @@
+---
+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

@@ -0,0 +1,78 @@
+---
+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 推理（低置信，必须标注推理依据，须人工确认才可进入基线）