项目收尾检查 Skill

项目结束后的最后一道门。确保下次打开项目时，文档是自洽的、问题是已追踪的、系统是可运行的。

---

知识导航表（执行前必须理解的概念根）

层级	文档	需要理解的概念
D0 认知根（必读）	_内部总控/认知结构/L1_系统性文档/系统架构思维维度/Skill体系设计原则_v1.0.md	§4 文档体系：K4项目规格文档（产品定义/技术架构/开发计划）的完整性要求；文档是结果不是原因
D3 规范参考	—	本 Skill 为只读审查，无修改操作（发现问题→路由到对应修复Skill）
D4 运行时数据	项目全部文档：产品定义.md + 技术架构.md + 开发计划.md + 问题追踪台.md	被审查的K4项目规格文档（审查对象）

核心概念速查： ① 收尾检查 ≠ 复盘：本 Skill 检查K4文档自洽性，project-retrospective 处理B/K对象Gap ② 三角色视角：PM视角（产品定义完整性）+ 架构师视角（技术文档准确性）+ 开发视角（实现与计划对齐） ③ 发现问题后路由，不直接修复：不同类型的问题路由到 issue-tracker / project-retrospective / role-* Skill

---

激活后立即执行（顺序不可跳过）

Step 1  Read: 产品经理/产品问题追踪台.md → 列出所有「未解决」项
Step 2  Read: 技术架构师/技术问题追踪台.md → 列出所有「未解决」项
Step 3  扫描核心文档完整性（见下方清单）
Step 4  检查代码/服务健康状态（见下方清单）
Step 5  输出收尾报告（见格式）
Step 6  引导经验沉淀（PD-001 Gap 修复）
        收尾报告完成后，主动提示：
        「✅ 收尾检查完成。
         下一步建议：说「做项目复盘」触发 project-retrospective，
         将本次调用过的 Skill 经验批量沉淀到 SKILL-INDEX，
         并处理 PENDING-EXPERIENCES 中的待处理条目。」

---

文档完整性检查清单

□ 产品设计文档（最新版）存在且有日期
□ 技术架构文档（最新版）存在且有日期
□ 开发计划（任务状态是否都已更新）
□ 开发计划是否包含本次新增功能/服务的任务条目（防止新工作漏登记）
□ 追踪台中的「已修复」条目有处理记录
□ 产品文档中「✅ 已实现」功能与代码实际吻合
□ 产品文档中「🔲 未实现」功能在追踪台或开发计划中有记录
□ workspace-main/skills/ 目录下的 Skill 文件与代码内置 Skill 是否同步
□ 高依赖度文档（跨项目协调框架、API契约、架构设计等被多个项目引用的治理文档）
  是否做了 F-022 挑战者反思 + 关卡B 审核（若未做，需在下次打开前补做）

---

代码健康检查清单

□ 服务是否可正常启动（前端 + 后端端口均可访问）
□ 无已知 P0 Bug 处于「未解决」状态
□ 测试文件是否在正确位置（不在 uvicorn watch 目录）
□ vite.config.ts 代理端口与当前后端端口一致
□ .env 配置完整（LLM_API_KEY、WORKSPACE_MAIN_DIR 等）

---

收尾报告格式

## 项目收尾报告 · [项目名] · YYYY-MM-DD HH:MM

### 一、未解决问题

#### 产品设计类（来自产品问题追踪台）
| ID | 描述 | 优先级 | 建议下步 |

#### 技术实现类（来自技术问题追踪台）
| ID | 描述 | 优先级 | 建议下步 |

### 二、文档状态
| 文档 | 状态 | 备注 |

### 三、服务状态
| 服务 | 端口 | 状态 |

### 四、下次打开前必做
（按优先级列出，让下次接手的人/AI 知道从哪里开始）

### 五、已完成亮点
（本次工作完成的核心功能，存档备忘）

---

变更记录

v1.2 — 2026-03-21 — 文档扫描清单补充2项（project-retrospective 20260321）

根因③（B类步骤偏差）：2026-03-21 项目收尾检查时，报告未主动提示「高依赖度治理文档（跨项目协调框架）未做 F-022 + 关卡B」，需用户主动发现并提醒，违反「收尾检查是最后一道门」的设计原则。

根因④（B类步骤偏差）：2026-03-21 twin-engine 服务创建后，开发计划.md 未加入新任务条目，收尾检查也未发现此遗漏，说明文档扫描清单缺乏此维度。

修改内容：

• 新增：文档完整性检查清单 □「开发计划是否包含本次新增功能/服务的任务条目」
• 新增：文档完整性检查清单 □「高依赖度文档是否做了 F-022 + 关卡B」

验证结果：

• 正向验证：下次收尾检查时，若开发计划未登记新功能，或治理文档未过关卡B，AI 应主动标注
• 负向验证：正常项目（无新增功能、无高依赖度文档）不受影响

验证状态：🔵 待验证

v1.1 — 2026-03-19 — 加入 Step 6 经验沉淀引导（PD-001 Gap 修复）

根因：PD-001 沙盘发现 project-closeout 完成收尾报告后没有任何机制触发 project-retrospective，造成产品开发域末端链路断裂，Skill 经验无法自动沉淀。

修改内容：

• 新增：Step 6「引导经验沉淀」——收尾报告完成后主动提示用户触发 project-retrospective

验证结果：

• 正向验证：project-closeout 完成后，AI 应输出指向 project-retrospective 的引导提示
• 负向验证：Step 1-5 的原有逻辑不变

验证状态：✅ 已验证（2026-03-19 tashan-openbrain 项目收尾：PM+Dev 双角色审查发现14项文档不一致问题，Step 6 经验沉淀引导成功触发）

---

2026-03-19 06:15 — 初始创建

根因：role-menu 中已注册此 Skill 但文件不存在，用户执行「项目收尾检查」时触发。 修改内容：首次创建，定义五步执行流程和收尾报告格式。