SuperAPI AI 工具集

up-repo

智能体与模型

查看项目

更新于 10-15 23:48

技能介绍

用途:根据当前会话中的变更,更新活跃仓库的文档,包括 README.md、docs/ 目录与 CLAUDE.md。核心做法是调度 up-docs-propagate-repo 子代理(Haiku)完成实际文件工作,主会话不再直接读写文件,以保持上下文精简。

主要能力与流程:先做预检,执行 git status --porcelain,若有未暂存改动则立即停止,列出脏文件并拒绝运行,提示先 stash 或 commit,以防数据丢失;确认干净后,检查 python3 是否可用,随后运行 context-gather.sh 收集会话上下文,并阅读 session-change-summary.md 模板生成具体的会话变更摘要(需写出确切的键、值与路径)。之后通过 Agent 工具以 subagent_type: "up-docs:up-docs-propagate-repo" 调度子代理,提示词以会话变更摘要开头,后接仓库特定上下文。子代理返回符合 summary-report.md 单层 Repo 格式的 Markdown 表格,技能将其直接作为最终输出透传,不自行编辑;若子代理失败,则输出单行失败说明。

后续步骤:读取 post-propagation-steps.md,先做陈旧文件候选审查——若输出含 Stale File Candidates 段落,用 AskUserQuestion 多选确认后仅对用户批准路径执行 git rm,无则静默跳过;再输出更新确认与基于探测得到的布局(V2/V1/NONE)交接简报。这两步对已更新状态文件只读。

适用场景:在 Claude Code 插件(l3digitalnet/claude-code-plugins)中使用,命令为 /up-docs:repo。

限制:需要 python3 在 PATH 中;工作区必须无未暂存改动;不做漂移审计,仅传播本次会话的具名变更,既有漂移不可见,需定期运行 /up-docs:drift 或 /up-docs:all。git rm 删除须经用户明确同意。其余细节暂未提供。