技能介绍

先定位问题，而不是先写文档

很多项目的起点只有一句话：「我想做个某某 App」。更多项目死在半路：README 写的是上一版设计，AGENTS.md 是 AI 三天前的猜测，聊天记录里的需求和仓库里跑的代码对不上。本技能处理的正是这种状态——想法不成型、旧项目不可信、多版本互相覆盖、AI 声称「已完成」却没有证据。

它不假设你懂 PRD、Git 或测试。你可以直接说「现在项目有什么问题」，它会先只读扫描项目根、Git 状态和测试，复述当前状态，区分已确认事实、相似证据推断和待验证假设，再决定下一步。

两个模块，三道门禁

技能内部有两条路由：新项目启动、接管旧项目、缺陷救援走 project-delivery-orchestrator；多版本共存、跨版本 PRD 冲突或候选待归档走 consolidate-project-versions + governance-model。两类需求同时存在时，先由版本治理模块只读审计并物化唯一候选，再交回总控，禁止两个模块并发写同一候选。

真正起作用的是三道硬门禁，由脚本执行而非自然语言判断：

validate_project_state.py --gate handoff：冻结的 PRD/UI 合同没准备好，不给开发任务启动包
validate_project_state.py --gate version-approval：没跑通验证和独立验收，候选不能变成当前版本
validate_semantic_coverage.py：逐条核对硬约束是保留、迁移还是有授权地取代，未通过就不能交接、归档或报告 anti-drift

语义约束保真是这套设计里最被低估的部分。它区分「冻结」「允许变化」「禁止变化」「开放决定」，防止某版本的私有技术选型被悄悄泛化或删除——这在 AI 生成的项目里几乎必然发生。

边界：它不做什么

用户说「批准」只代表授权意图，不等于 PRD 被批准、测试通过或验收通过。缺证据时只记录 version_approval_intent=received，状态保持 pending。硬边界还包括：不删除文件（含 Trash）、不自动 commit/push/upload、不碰生产库、未确认项目根时不写默认路径、不假装任务创建成功（当前 WorkBuddy 基线没有任务 API，只生成可复制的启动 Prompt）。专业 PRD Skill 是可选增强，缺失时回退内置最小 PRD。