89 lines
5.0 KiB
Markdown
89 lines
5.0 KiB
Markdown
# 阶段 ⑧ 学习与沉淀（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](README.md) 变更记录）。 |
|
||
|
||
---
|
||
|
||
## 3. 输出规范
|
||
|
||
### 3.1 学习捕获模板
|
||
|
||
```text
|
||
机会类型： 一次性修正 | 重复机会 | 熵增维护 | 能力缺口 | 无候选窗口
|
||
证据： 可比任务（id/日期/摩擦点）或 资产+不变量+检查
|
||
覆盖面检查： 观察 → 内置 → 已配置 → 扩展 → 新建（勾选已试层级）
|
||
最小 owner： 文档/技能/脚本/门禁/记忆（+ 触发/输入/验证器/停止规则）
|
||
验证方式： 可比后续结果 | 定期维护检查（权威真相 + owner + 频率）
|
||
状态： 已捕获（Exercised）/ 缺口（证据 + owner）/ 无候选
|
||
```
|
||
|
||
### 3.2 捕获落点
|
||
|
||
| 捕获类型 | 落点（本仓） |
|
||
|---|---|
|
||
| 流程/阶段缺陷 | 本目录对应阶段文档（带版本变更记录） |
|
||
| 代码事实/架构决策 | `docs/architecture/`（architecture-overview / codemap / flows / data-model 等基线）、ADR |
|
||
| 重复过程/命令 | 脚本、`scripts/`、技能（`skills/`） |
|
||
| 测试缺口 | `docs/architecture/testing-architecture.md`（测试体系单一事实源） |
|
||
| 长期记忆 | agent 记忆系统 / 项目 memory（本仓：`docs/memory/` 本地工作文档与记忆架构，不入库） |
|
||
|
||
### 3.3 交付物清单
|
||
- 学习捕获记录（模板一份，可并入交付总结）
|
||
- 实际落地的捕获产物（文档/脚本/技能/门禁 + 使用证据）
|
||
- 长期验证契约（谁、何时、怎么判 clean/gap）
|
||
|
||
---
|
||
|
||
## 4. 反模式
|
||
|
||
- **一次事故当规律**：单个事件、命令 token、计数、文件名当重复证据。
|
||
- **跳过覆盖阶梯**：已有机制没试就先新建 Skill/脚本。
|
||
- **沉淀完就完**：创建后无触发、无验证器、无停止规则，也从没被用过。
|
||
- **同窗宣称效果**：同一窗口的修复验证冒充"长期有效"。
|
||
- **文件年龄当结论**：没和权威真相对比就宣布依赖/文档过时。
|
||
|
||
---
|
||
|
||
## 5. 轻量路径（小改动）
|
||
|
||
- 小任务：在 PR 描述或交付总结里加一小节（机会类型 + 落点 + 验证方式）即可。
|
||
- 重大发布/反复摩擦的项目：必须完整执行本阶段。
|
||
|
||
---
|
||
|
||
## 6. 相关文档
|
||
|
||
- 输入：阶段 ⑦ [07-delivery.md](07-delivery.md) 及全程证据
|
||
- 流程总览与变更记录：[README.md](README.md)
|