5.1 KiB
5.1 KiB
阶段 ⑧ 学习与沉淀（Learning & Capture）
定义：识别生命周期机会（重复工作、熵增维护、能力缺口），把被支持的改进沉淀为最小的持久 owner（文档/技能/记忆/检查），并让沉淀保持准确、长期有效（长期验证）。学习不只是在项目结束时做，而是每个任务闭环后都要做。 输入：①–⑦ 全程产生的摩擦、重复、缺口、成功过程。 输出：学习捕获（本流程文档/仓库 docs/skills/记忆/门禁）+ 后续验证契约。 进入下一阶段（回到 ①，或项目收尾）：捕获落档，owner 明确。
1. 要求（Requirements）
1.1 进入条件
- 本任务已交付（⑦ 完成）或中途出现明确重复/熵增信号。
1.2 完成条件（DoD）
- 已区分"一次性问题"与"可复用机会"：重复工作（≥2 个可比任务同样意图+同样摩擦/成本）才进循环工程
- 被捕获的改进有：触发方式 / 稳定输入 / owner / 工具与权限 / 产物 / 验证器 / 停止规则
- 覆盖面检查做过：已有能力（观察→内置→已配置→扩展→新建）优先于新建
- 捕获产物同步到正确 owner：流程缺陷 → 本目录；代码事实 → 文档/测试；重复过程 → 技能/脚本
- 长期验证方式已写明（可比后续结果 或 定期维护检查），未验证的效果不作宣称
2. 规则（Rules）
| 编号 | 规则 |
|---|---|
| R-8.1 | 重复才算机会：一次偶发不算；两次可比任务 + 可复现的摩擦/成本/成功过程才构成重复机会。当前一次交接只能产生"当前维度"的建议，不能证明复现。 |
| R-8.2 | 最小 owner：先查覆盖阶梯（已有机制 → 内置 → 已配置 → 扩展 → 新建），选择最小持久 owner；不默认新建 Skill/脚本。 |
| R-8.3 | 可运行才算沉淀：沉淀必须有触发、输入、验证器与停止规则，且被实际使用过（Exercised）；仅创建未使用 = 未沉淀。 |
| R-8.4 | 不空置缺口：观察到需求但无持久覆盖时，留下显式缺口条目（owner + 证据），不悄悄丢弃。 |
| R-8.5 | 效果需长期证据：只有在可比后续结果中观察到改进（且无护栏回归）才能宣称"有效"；同窗口验证只证明修复状态，不证明长期效果。 |
| R-8.6 | 维护类机会需可判定：熵增/过时（依赖、文档、命令、版本）必须有命名的资产/不变量、权威真相、可运行的检查（返回 clean/gap/needs-evidence），文件年龄/提交历史本身只是线索，不是判定。 |
| R-8.7 | 流程本身可演进：本流程文档的缺陷、反模式、新规则，经确认后回写（带版本与变更记录，见 README.md 变更记录）。 |
3. 输出规范
3.1 学习捕获模板
机会类型： 一次性修正 | 重复机会 | 熵增维护 | 能力缺口 | 无候选窗口
证据： 可比任务（id/日期/摩擦点）或 资产+不变量+检查
覆盖面检查： 观察 → 内置 → 已配置 → 扩展 → 新建（勾选已试层级）
最小 owner： 文档/技能/脚本/门禁/记忆（+ 触发/输入/验证器/停止规则）
验证方式： 可比后续结果 | 定期维护检查（权威真相 + owner + 频率）
状态： 已捕获（Exercised）/ 缺口（证据 + owner）/ 无候选
3.2 捕获落点
| 捕获类型 | 落点（本仓） |
|---|---|
| 流程/阶段缺陷 | 本目录对应阶段文档（带版本变更记录） |
| 代码事实/架构决策 | docs/v2/02-architecture.md与09-decisions.md，或对应已存在业务文档 |
| 重复过程/命令 | 脚本、scripts/、技能（skills/） |
| 测试缺口 | docs/v2/06-validation.md、backend/test_*.py与相关scripts检查；待实现不标通过 |
| 长期记忆 | 工程决策入库docs；业务经验通过assistant_experiences治理；会话/真实案例/凭据不因沉淀而提交Git |
3.3 交付物清单
- 学习捕获记录（模板一份，可并入交付总结）
- 实际落地的捕获产物（文档/脚本/技能/门禁 + 使用证据）
- 长期验证契约（谁、何时、怎么判 clean/gap）
4. 反模式
- 一次事故当规律：单个事件、命令 token、计数、文件名当重复证据。
- 跳过覆盖阶梯：已有机制没试就先新建 Skill/脚本。
- 沉淀完就完：创建后无触发、无验证器、无停止规则，也从没被用过。
- 同窗宣称效果：同一窗口的修复验证冒充"长期有效"。
- 文件年龄当结论：没和权威真相对比就宣布依赖/文档过时。
5. 轻量路径（小改动）
- 小任务：在 PR 描述或交付总结里加一小节（机会类型 + 落点 + 验证方式）即可。
- 重大发布/反复摩擦的项目：必须完整执行本阶段。
6. 相关文档
- 输入：阶段 ⑦ 07-delivery.md 及全程证据
- 流程总览与变更记录：README.md
变更：XB-1.0 / 2026-09-28，按兴邦 Next.js + FastAPI 项目事实适配；稳定规则编号保留。