SuperAPI AI 工具集

soia-dev-doc-sync

编程与开发

查看项目

更新于 10-16 08:41

技能介绍

用途:把代码、版本元数据、发布记录等明确真源与 docs/、README、CHANGELOG、VERSION 等派生文档逐项对账,报告事实漂移并在授权范围内修复。适用于发布、版本升级、架构或 API 变更后回填文档,以及多语言页面处于不同事实时间切片时检查文档漂移。

主要能力:建立真源清单并比较每项声明与证据;按 status-drift、coverage-gap、version-drift、release-drift、structural-drift、bilingual-drift、historical-snapshot-gap、link-or-reference-drift 分类漂移;每项 finding 记录真源与派生位置、摘录、预期值、观察值与建议动作,区分推断与已验证事实;按依赖顺序修复,派生层不得领先上游事实。

使用方式:提供目标仓库、待检查文档范围与已知真源;真源优先级不明时先确认,不用旧文档互相佐证。真源默认顺序为可执行或机器可读事实(代码、schema、manifest、锁定版本、生成输出、测试结果)、维护的发布事实、已审阅设计记录、派生叙述。涉及覆盖、删除、发布或远端状态时先展示目标、影响与补丁预览并取得确认。安装命令:npx skills add soia-team/soia-open-dev-coding-skills -g -a '*' -s soia-dev-doc-sync -y。

限制:强依赖目标仓库及真源文件的只读访问;可选使用项目已有 lint、测试、生成器或链接检查器,缺少时如实报告未覆盖的验证面。不将派生文档反向视为真源,不虚构发布状态、测试结论或支持承诺,不在未授权时发布或覆盖远端文档。同级真源冲突时停止自动回填并报告冲突。普通单篇创作、纯翻译或无需事实对账的文案不触发本技能。具体收费与价格暂未提供。