用途:生成长度可控、有证据支撑的项目状态简报,并推荐单一的下一步行动。整次运行保持只读,不修改代码、文档、规划状态、git 状态或 GitHub 状态;简报结束后即停止,实施需另行请求。
核心原则是三角验证:计划、路线图、TODO、交接和状态文档只代表意图或记忆中的状态,须用独立的仓库证据核实后才可作为当前现实呈现。
主要步骤:一、建立快照,读取适用说明文件并遵守用户指定的范围,先记录本地基线,包括当前分支、上游分支与领先/落后状态、已暂存/未暂存/未跟踪工作及近期提交历史,再发现仓库的路由与状态来源(README、架构文档、路线图、计划、任务列表、进度文件、交接)。二、对可能影响结论的每项声明,用工作区 diff、提交历史、实际实现与接线、相关测试、产物或 CI 结果等至少一个独立来源检验,并归类为已验证、漂移(证据实质矛盾)或未验证(证据不足不等于矛盾);仅在诊断已确立、足够快且副作用明确时运行针对性检查,否则参考既有 CI 证据,并列出未运行的检查。三、在存在 GitHub 远端且可访问时,用 gh 列出打开的拉取请求及其草稿状态、分支、审查/检查状态和近期活动,仅在与当前计划、提交、PR、里程碑或用户范围相关时查看 issue;远端、认证或网络不可用时说明盲点。四、按用户明确指示、进行中的本地或 PR 工作、阻塞与失败检查或审查关卡、已验证的规划意图、有支持的排队计划或相关 issue 的顺序,推荐最小且具体的下一步行动,指出目标、理由和第一步;若两种行动同等合理则说明所需决策。五、输出简报,先给底线结论,再按需包含当前状态、近期动向、证据与漂移、相关 PR 与 issue、阻塞与盲点、推荐下一步行动,区分观察、文档声明与推断,附简洁的文件/提交/检查/PR/issue 引用,避免原始命令输出、完整文件清单和通用代码审查。结束前对照基线确认未引入仓库或远端变更,仅清理本次诊断产生的附带产物,并报告无法安全撤销的变更。
限制:依赖本地仓库与可用远端访问;无规划系统本身作为发现而非阻塞;未提供的功能、收费或平台信息暂未提供。