用途:该技能用于把事实清单与代码库实际行为同步。仅当用户明确要求发现(discover)、审计(audit)或同步(sync)事实时使用;若用户说“处理事实”或“添加事实”,应改用 facts 技能来定义规格,而不是本技能。
主要能力:扫描代码库并按生命周期分类每条事实——@draft 表示含糊或高层、需细化;@spec 表示精确可执行但代码尚未支持;@implemented 表示事实为真且代码可证;无标签表示从代码发现并已由观察验证的既成事实。此外可补充尚未记录的重要事实、修正不准确事实、删除过时事实,并为可验证的手动事实添加命令,使事实能自动捕捉回归。
使用方式:运行 facts list 查看现有事实,运行 facts check 查看哪些命令型事实通过或失败。用 facts edit <id> --add-tag、--label、--command 修改,用 facts remove <id> 删除。短别名可用:ll、at、rt、rm 和 ls。多文件项目可将事实拆分到 cli.facts、api.facts 等。
组织与领域:可在 .facts 主文件的 ## domain 段定义跨模块出现的实体,如 a <Name> is <definition>,并记录实体间关系;只有跨多个区域出现的概念才需定义。事实应按 --section 分组,支持嵌套路径。
限制:命令必须可证伪、快速、幂等、稳定且成功时静默,避免仅用关键字 grep 做无意义校验;主观、涉及人工流程、外部系统或设计意图的事实应保持手动。事实过多时应拆分文件并裁剪结构性冗余内容。具体支持的平台、收费及价格信息暂未提供。