技能介绍

项目收口要解决什么问题

接手一个陌生项目时，你通常只能靠 README、AGENTS.md 或随手留下的交接文档拼凑出"项目大概是做什么的"。但真正重要的是：入口在哪里、验证结果是否可信、失败后从哪里恢复。知硕项目收口就是为这个场景设计的——它不整理代码，而是证明未来的人能找到真实入口、理解边界、验证结果并从失败处恢复。

技能如何工作

核心能力是默认以只读方式检查源码和状态，在对话中交付报告。整个过程分为七个步骤：

定位真实边界：区分"目录路径""真实路径""Git 根"和"工作区容器"，避免把外层脏文件归到错误项目
建立项目地图：用白话回答项目解决什么真实问题、数据从哪里进入、关键文件分别负责什么、哪些是用户判断哪些由 Agent 主要实现
核对入口与产物：找到实际可运行入口、前置条件、配置来源和输出目录；入口说明与代码不一致时，以真实代码和运行结果为准
分层验证：先判断已有验证是否会生成缓存或产物，再运行低风险自动化；报告逐项写明"已运行、通过/失败、覆盖边界、未覆盖边界、生成了哪些可忽略产物"
记录失败恢复：列出已知失败、可观察症状、真实原因、恢复命令，让未来使用者能区分"可以重试""要先修复条件""必须询问用户"
核对 Git 与交付范围：检查未提交、已暂存、忽略文件，所有未提交文件都被解释为本轮、用户既有或未知
交付收口报告：按模板输出，能回答入口、产物、验证、失败恢复、Git 状态、未完成项和下一次最小动作

适用边界

技能遵循严格的安全边界：不自动提交、推送、打标签、删除产物或清理用户工作区。运行验证命令前先说明，并核对生成产物的归属；用户要求严格零写入时不运行会落盘的验证。当目标路径不明确、仓库根存在争议、验证会改变外部状态、需要登录/付款/真实设备或工作区包含无法归属的改动时，技能会先完成其余只读检查，然后明确请求缺失条件，而不是用"看起来完成"结束。