TashanGKD 项目收尾检查 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 但文件不存在，用户执行「项目收尾检查」时触发。 修改内容：首次创建，定义五步执行流程和收尾报告格式。