SuperAPI AI 工具集

discover-repository-state

通用与其它

查看项目

更新于 10-15 21:56

技能介绍

用途:在规划或实现之前,为仓库建立一份可审查的证据快照(Normalized Repository State),作为后续规划与执行的权威依据,避免未经核实的信息混入决策。

主要能力:先读项目向导、文档地图及已有的 docs/workflow/REPOSITORY_STATE.md;再检查仓库文件、测试、git 状态与声明的工具链,仅在 Repository Facts 中记录直接观察到的内容,每条附 file:line 或命令证据。设计记录归入 Accepted Decisions,路线图归入 Planned work,仅文档声明归入 Documentation,推理归入 Inference,未解歧义归入 Open Questions。

使用方式:按技能定义的处理流程逐步执行。若无斜杠菜单,可在新一轮对话中打开该文件并遵循其流程。若已有快照被现有证据推翻,保留其状态并交由 resolve-repository-state;若新证据与已冻结事实冲突,则追加 Contradiction、将状态设为 contradicted,且不改动原事实;仅当不存在任何新旧矛盾时,才将快照状态设为 frozen,提交产物并标注来源修订版本。收尾打印 Next 块:有矛盾时下一步为 /resolve-repository-state,否则为 /unit-lane,已完成分诊的单元可执行 /execute-phase。

限制:只记录仓库事实并分栏保存决策、计划、文档、推断、问题与矛盾,仓库本身始终为权威来源,快照过期需刷新;不得生成实现建议,不得静默接受决策。完成标准是账本处于 frozen 或明确 contradicted,且每条事实都有直接证据。