SuperAPI AI 工具集

sync-findings

办公与效率

查看项目

更新于 10-16 03:12

技能介绍

用途:保持当前 findings 记录与本地状态(以及可选的 GitHub PR 状态)一致,把 PR 评论、评审备注、本地评审文档和当前代码状态映射到 findings,更新来源与状态,并提出待确认问题。

输入:可选 path(本地设计或 findings 文件夹,省略时按分支、子系统或匹配文档推断并说明推断值,默认 path=infer);可选 GitHub PR url(提供时执行远程加本地同步,未提供时仅本地同步,默认 url=local-only)。

主要流程:先确认有效变量(path、url、分支、PR URL、关注范围);加载 path/findings.md 中的活动记录;必须保存优先——在做任何代码修改、修复建议、回复线程或其他文档更新之前,先把每条新 finding 按既定 schema(ID、severity、files、evidence、decision pending)写入 ## Open Findings,标记为 needs-user-decision(除非用户已给出指示),并刷新 ## Summary。之后重新核对已有 findings 与当前本地代码和文档,若提供了 url 则拉取打开的 PR 评论与线程状态。对仍不明确的 finding,提出下一个具体问题;仅关闭明确由当前 findings 解决且已闭环的 GitHub 线程,可回复并附 finding ID,其余线程保持不动。

规则与限制:保存优先为强制要求,无例外;同步不替代执行规划,需要决定下一步时应使用 triage-findings;不得静默丢弃来源、线程 ID 或评论出处。依赖共享参考 ../shared/references/findings.schema.md 与 ../shared/references/findings.lifecycle.md。具体安装或运行命令、收费与平台信息暂未提供。