SuperAPI AI 工具集

changeset-doc-sync

通用与其它

查看项目

更新于 10-16 06:43

技能介绍

用途:当发布文档需要与当前 changeset 内容对齐时使用该工作流。它要求先审查 /example 目录的迁移改动,再读取 www 与 packages/kitcn/skills/kitcn 下的全部文档并同步,最后通过清单勾选追踪每个文件是否已处理。

主要流程与能力:先运行 preflight 迁移审查并保存结论;创建或延续 docs/plans/<date>-changeset-doc-sync.md 目标计划,并建立覆盖每个改动文件的 /example 交叉对照清单。随后解析 .changeset/.md(排除 README)中的 breaking、features、patches 与迁移片段,为目标计划建立执行清单,覆盖 www/**/.md、www//*.mdx、packages/kitcn/skills/kitcn//*.md 全部文件。逐份阅读并同步文档,完成后标记“updated”或“no change needed”。

必要用法:迁移审查命令为 git diff --name-only -- example、git diff --stat -- example、git diff -- example;新建计划时使用 node .agents/skills/autogoal/scripts/create-goal-scratchpad.mjs --template task --title "changeset doc sync";完成校验使用 node .agents/skills/autogoal/scripts/check-complete.mjs docs/plans/<date>-changeset-doc-sync.md。

完成条件:交叉对照清单与目标计划均无未勾选项,记录扫描/更新/未变更总数,并把关键文档改动映射到具体 changeset 条目。限制:清单必须逐文件列出,不能只写汇总数字;任一文件未勾选即视为未完成;任何改动的 /example 文件若没有对应文档检查或无影响说明即为硬性失败。具体安装方式与更多参数暂未提供。