SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场setup-agent-skills

setup-agent-skills

编程与开发

查看项目

更新于 10-16 10:05

技能介绍

用途

setup-agent-skills 用于为某个代码仓库搭建工程技能所依赖的按仓库配置（per-repo configuration）。根据资料，这些技能假设仓库已具备统一的议题跟踪、分诊标签和领域文档约定，本技能负责一次性初始化这些约定，应在首次使用相关工程技能前运行一次。

主要能力

该技能搭建的内容包括三类：

  • 议题跟踪器（Issue tracker）：议题存放的位置。默认 GitHub，同时开箱支持本地 markdown；也支持 GitLab。
  • 分诊标签（Triage labels）：用于五个规范分诊角色的字符串。
  • 领域文档（Domain docs）：GLOSSARY.md 与 ADR 的存放位置，以及读取它们的消费规则。

本技能是提示驱动的技能，不是确定性脚本：先探索，展示发现，与用户确认，然后写入。

使用方式

资料描述的处理流程分五步。

  1. 探索（Explore）：查看仓库当前状态，读取已存在的内容而不做假设。检查项包括：git remote -v 和 .git/config（是否为 GitHub 仓库、是哪一个）；仓库根目录的 AGENTS.md 与 CLAUDE.md 是否存在，是否已有 ## Agent skills 段落；根目录的 GLOSSARY.md 和 GLOSSARY-MAP.md；docs/adr/ 以及任何 src//docs/adr/ 目录；docs/agents/ 是否已有本技能此前的输出；.scratch/ 是否表明已在使用本地 markdown 议题跟踪约定；triage 技能是否已安装（决定 Section B 是否运行）；monorepo 信号（pnpm-workspace.yaml、package.json 中的 workspaces 字段，或 packages/ 下带自己 src/ 的目录），这些只在真正的大型多包仓库中出现，没有则视为单上下文。

  2. 展示发现并询问（Present findings and ask）：先总结已有什么、缺什么，然后按顺序逐节处理，一节一个回答再进行下一节。每节先给出推荐答案，让用户用一个词即可接受；只有当选项确实分叉时才给一行说明；若探索已确定某项，则整节跳过（未安装 triage 时跳过 Section B，没有 monorepo 时跳过 Section C）。

Section A：议题跟踪器。默认姿态是这些技能为 GitHub 设计。若 git remote 指向 GitHub，推荐 GitHub；若指向 GitLab（gitlab.com 或自托管主机），推荐 GitLab；否则（或用户偏好）提供以下选项：GitHub（议题存于仓库的 GitHub Issues，使用 gh CLI）、GitLab（使用 glab CLI）、本地 markdown（议题作为 .scratch/<feature>/ 下的文件，适合个人项目或无远程仓库）、其他（Jira、Linear 等，请用户用一段话描述工作流，技能将其记录为自由文本）。选择记录在 docs/agents/issue-tracker.md。GitHub 与 GitLab 模板带有一个“PRs as a request surface”标志，默认关闭，保持关闭且不主动提出。

Section B：分诊标签词汇表。若未安装 triage 技能则整节跳过。若已安装，只问一个问题：是否保留默认分诊标签（推荐：是）。默认值即五个规范角色，每个标签字符串等于其名称：needs-triage、needs-info、ready-for-agent、ready-for-human、wontfix。回答是则按原样写入。只有用户说不时（通常因其跟踪器已用其他名称，如用 bug:triage 代替 needs-triage），才收集覆盖值，使 triage 应用已有标签而非创建重复项。

Section C：领域文档。默认单上下文（仓库根目录一个 GLOSSARY.md 加 docs/adr/），适配几乎每个仓库，无需询问直接写入。仅当探索发现 monorepo 信号时才提供多上下文（根 GLOSSARY-MAP.md 指向各上下文的 GLOSSARY.md 文件），此时确认用户想要哪种布局。

  1. 确认并编辑（Confirm and edit）：向用户展示草稿，包括将添加到 CLAUDE.md / AGENTS.md 的 ## Agent skills 区块，以及 docs/agents/issue-tracker.md、docs/agents/domain.md、docs/agents/triage-labels.md（最后一个仅在安装 triage 时）的内容，允许用户在写入前编辑。

  2. 写入（Write）：选择要编辑的文件。若 CLAUDE.md 存在则编辑它；否则若 AGENTS.md 存在则编辑它；若两者都不存在，询问用户创建哪一个，不要替其选择。当 CLAUDE.md 已存在时绝不创建 AGENTS.md（反之亦然），始终编辑已存在的那个。若所选文件中已存在 ## Agent skills 区块，则就地更新其内容而非追加重复项，且不要覆盖用户对周边段落的编辑。该区块结构为：## Agent skills 下含 ### Issue tracker、### Triage labels、### Domain docs 三个子块，各含一行摘要并分别指向 docs/agents/issue-tracker.md、docs/agents/triage-labels.md、docs/agents/domain.md。仅当 triage 已安装且 Section B 运行时，才包含 ### Triage labels 子块并写 docs/agents/triage-labels.md；否则两者都省略。随后使用本技能文件夹中的种子模板写入文档文件：issue-tracker-github.md、issue-tracker-gitlab.md、issue-tracker-local.md、triage-labels.md（仅在安装 triage 时）、domain.md。对于“其他”跟踪器，依据用户描述从头编写 docs/agents/issue-tracker.md。

  3. 完成（Done）：告知用户设置完成，以及哪些工程技能将读取这些文件；并说明用户日后可直接编辑 docs/agents/*.md，只有在想切换议题跟踪器或从头重来时才有必要重新运行本技能。

适用场景

适用于需要按仓库初始化工程技能配置的代码仓库，包括单仓库与检测到 monorepo 信号的大型多包仓库，以及使用 GitHub、GitLab、本地 markdown 或其他议题跟踪器的团队或个人项目。

限制

资料未提供本技能的收费标准、价格、具体平台覆盖范围或效果数据，暂未提供。资料未给出独立的官方介绍文本（official_text 为空）。本技能为提示驱动而非确定性脚本，其行为依赖探索结果与用户确认。