SuperAPI AI 工具集

facts-refine

通用与其它

查看项目

更新于 10-15 17:22

技能介绍

用途:facts-refine 是一个“事实表编辑”技能,负责把 @draft 事实(草稿)通过与用户对话协作,精炼为精确、可执行的 @spec 事实,完成 @draft → @spec 的生命周期转换,而不是自动化批处理。

适用时机:当 @draft 事实需要精炼——把模糊想法拆成原子化规格、解决矛盾、补齐覆盖缺口、锐化标签,使每条事实精确到可实现时使用。

主要能力:它扫描并处理多类问题,包括结构性而非行为性的事实、含糊或不可测的事实、覆盖缺口、相互矛盾的事实、复合事实(一条堆叠多个独立断言)、领域词汇不一致,以及整理机会(合并近似重复、把微事实整合为特性契约、超过约 80 条时拆分或精简)、校验命令质量问题。

使用方式:典型命令包括 facts list、facts list --tags "draft"、facts check、facts lint。修改命令如 facts edit <id> --label "sharper label" --remove-tag "draft" --add-tag "spec"、facts add "..." --section ... --tags "spec"、facts remove <id>。还提供高频操作别名:ll(list --light)、at <id> <tag>(quick --add-tag)、rt <id> <tag>(quick --remove-tag)、rm、ls,额外参数会被转发;详见 facts --help 或 facts skills show facts。编辑领域事实时用 a <Name> is <definition> 定义实体、a <Name> <verb>s <Name> 定义关系。

流程:加载并识别 @draft 事实;识别问题;按严重程度(先矛盾,再缺口、含糊、复合事实、词汇不一致)分批与用户讨论;用户同意后立即应用改动;最后用 facts check 与 facts lint 验证并总结。

限制:每次改动都需用户同意,先提议后决定;优先锐化而非删除;拆解复合事实时保留原意;不要添加并非真正检验该断言的校验命令(宁可用手动事实也不要假校验);不要随意重组章节或重命名,除非确有必要;精炼非 ## domain 的事实时要核对实体名与主 .facts 文件中 domain 章节一致。若用户想新增事实而非精炼,则属于 facts 技能而非本技能。示例:d4e“handles auth correctly”拆为三条 @spec,f6g 复合事实拆分,补 api/auth 限速缺口,4 条 webhook 错误码合并为 1 条。关于收费、价格、平台或效果等事实,资料未提供。