SuperAPI AI 工具集

ai-setup-skills

通用与其它

查看项目

更新于 10-15 20:29

技能介绍

用途:为仓库配置工程技能所需的说明文件,设置问题跟踪器与分诊标签词汇,应在首次使用其他工程技能前运行一次。

主要能力:该技能负责生成并维护三类仓库输出:docs/agents/issue-tracker.md、在流程包含分诊标签时的 docs/agents/triage-labels.md,以及 AGENTS.md 或 CLAUDE.md 中唯一的根级 ## Agent skills 段落。它不负责领域文档,GLOSSARY.md、GLOSSARY-MAP.md、ADR、docs/agents/domain.md 及 ## Agent skills 段落之外的说明均保持不变。

使用方式:流程分六步。第一步只读检查,用 git rev-parse --show-toplevel 解析仓库根目录并转为规范物理路径,检查 git remote -v 与 .git/config、根 AGENTS.md 和 CLAUDE.md、已有 ## Agent skills 段落、docs/agents/issue-tracker.md 与 docs/agents/triage-labels.md、.scratch/ 以及分诊技能是否安装。第二步选择跟踪器,逐段询问并优先给出推荐答案:GitHub(通过 gh 使用 GitHub Issues)、GitLab(通过 glab 使用 GitLab Issues)、本地 markdown(.scratch/<feature>/ 下文件)、Obsidian($OBSIDIAN_AI_VAULT/engineering/<project>/workplans/<feature>/ 下文件)、Workplan(通过 wp --json 的本地跟踪器及其 Workplan 技能)或用户用一段话描述的其他工作流。Workplan 固定使用五个规范标签 slug:needs-triage、needs-info、ready-for-agent、ready-for-human、wontfix。第三步展示拟写入的完整内容并等待用户批准,批准前不得改动仓库。第四步配置所选跟踪器,Workplan 需读取并执行 setup-workplan.md。第五步仅写入其负责的说明文件,替换模板占位符,保留段落外所有字节。第六步报告配置结果。

适用场景:需要在仓库中统一工程技能的问题跟踪与分诊标签配置时。

限制:不创建远程标签或改动所选跟踪器;不处理领域文档;若存在多个根级 ## Agent skills 标题需停止并询问;重复运行会重建其负责的配置而不影响无关说明或领域文件。其他细节暂未提供。