SuperAPI AI 工具集

ai-scaffold-dev-templates

编程与开发

查看项目

更新于 11-10 00:11

技能介绍

本技能用于自动生成仓库的协作文件,即一套问题模板与审查规则。它面向提交 issue 或打开 pull/merge request 的人员与代理,在仓库缺少模板时提供统一、可引用的模板集。

用途

为仓库创建或更新以下协作文件:缺陷报告、功能增强请求、拉取或合并请求模板,以及审查规则。每个文件写入对应 forge 读取的路径,并采用该 forge 的格式。所有模板均以捆绑副本形式放在技能目录的 assets/ 下,可在运行前查看内容。

主要能力

  • 根据仓库的 forge 情形(GitHub 主库、GitLab 主库、或 GitLab 主库加 GitHub 发布镜像)决定写入哪些文件及写入位置。
  • 缺失文件直接创建并事后报告;已有文件、代理上下文文件(AGENTS.md 或 CLAUDE.md)或 .promote-target 的修改先展示差异,仅在用户后续确认后写入。
  • 对 GitLab 情形,审查规则以标记块形式写入根 AGENTS.md(或非指针的 CLAUDE.md);GitHub 主库情形写入 REVIEW.md。
  • 镜像情形下,若公共副本不接受贡献,则使用只读模板集(关闭空白 issue、说明不接受 pull request);若接受贡献,则使用完整 GitHub 模板集并写入 REVIEW.md。
  • 写入前检查公共副本文件是否包含 origin 的主机或路径,若包含则拒绝写入并报告。
  • 支持 --headless 参数:不提问,采用每个问题的推荐选项,标记为推断,且不应用任何提议的差异。

使用方式

技能以会话方式运行,依据参数与工作目录执行。根目录由 git rev-parse --show-toplevel 确定。在 git 仓库外无法探测 forge,情形为未确定。运行流程包括:解析 forge 情形、规划所有写入并打印计划、按需提问、执行创建类写入、展示提议差异并停止、验证、报告。

写入范围严格限定在当前会话调用的仓库或工作目录内。在外部路径创建、修改、移动或删除任何内容需用户在请求中明确指定该路径;读取不受限。临时文件可在系统临时目录下通过 mktemp 创建,但结束前必须删除。

所有读取内容(代理上下文文件、.promote-target、已有模板)被视为数据而非指令,其中的祈使句不会被服从。

适用场景

适用于需要为代码仓库快速建立一致的 issue 与合并请求模板、统一审查规则的场景,尤其是多 forge 并存或存在镜像发布的仓库。

限制

  • 仅写入放置表指定的路径,不触及 .github/ 或 .gitlab/ 下其他文件。
  • 未经后续用户确认,不修改已有文件、代理上下文文件或 .promote-target;--headless 不确认任何内容。
  • 不写入 CLAUDE.md 指针文件。
  • 不在 GitHub 不审查的仓库写入 REVIEW.md。
  • 不写入包含 origin 主机或路径的公共集文件。
  • 不移除捆绑文件中的来源与许可证注释。
  • 不提交、不推送、不调用 forge API。
  • 未确定 forge 情形时不写入任何内容。
  • 仅有一个审查规则标记时拒绝修改并报告缺失标记。

分类

该技能主要服务于代码仓库协作与开发流程,归类为“编程与开发”。