SuperAPI AI 工具集

sync

部署与运维

查看项目

更新于 10-15 23:42

技能介绍

用途:在变更完成或接近合并时运行 /sync,把仓库现状同步到持久化知识文件中,形成收尾闭环。

主要能力:维护根目录和嵌套 AGENTS.md;将根 AGENTS.md 的 Build approach 行与作用域头部的方案对齐(单行微调);在最近 AGENTS.md 中为设计系统 design.md 添加一行指针;为本变更新出现的区域创建嵌套 AGENTS.md 并添加根指针;把 ADR 的 Status 行与功能作用域状态对齐(planned→Proposed,in-progress→In Progress,done→Accepted);按仓库证据勾选作用域中已完成的子任务并推进状态。

边界:不创建或重构根 AGENTS.md、不为既有未记录区域创建浅层嵌套文档(改为提示运行 /audit)、不编辑 ADR 正文或取代它(改为提示 /architect)、不新增或重排作用域中的功能与子任务、不重写人工维护的 AGENTS.md 正文(改为标记冲突)。创建的标准是上下文而非策略:仅当本变更能呈现整个区域时才创建,否则标记。

使用方式:命令基于 git。先做新鲜度检查:git fetch --quiet,若 git rev-list --count HEAD..origin/$BASE 大于 0 则提示先拉取。基准为 main(若 git rev-parse --verify main 成功),否则 master;当前分支用 git rev-parse --abbrev-ref HEAD。已提交模式用 git merge-base "$BASE" HEAD 后 git diff --name-status <merge-base>;未提交模式用 git diff --name-status HEAD;未跟踪文件用 git ls-files --others --exclude-standard 并标记 A。维护规则以 agent-prompt.md 为准,由主线程在写入时内联执行。

限制:无源码与依赖清单变更时停止,无可同步内容。文档、配置、测试、锁文件、生成产物不作为变更来源。仅 git 为必需 CLI,其余 shell 片段为 POSIX 参考,不可假设 find、grep、sed 等存在。支持任意操作系统与智能体。

其他:若依赖清单变化,可只读子代理检索相关 Agent Skill 与可选 MCP,候选以多选面板呈现,绝不自动安装或连接;发现结果携带为 INSTALLED_SKILLS_OR_NONE、MCP_SERVERS_OR_NONE、DECLINED_TOOLS_OR_NONE。基础设施与更细的参数(如收费、平台支持、部分路径细节)暂未提供。