SuperAPI AI 工具集

setup-matt-pocock-skills

办公与效率

查看项目

更新于 10-16 04:16

技能介绍

用途

本技能用于搭建 Matt Pocock 工程类技能所依赖的按仓库配置。它并非确定性脚本,而是提示驱动流程:先探索仓库,展示发现结果,与用户确认后再写入文件。

主要能力

该技能生成的配置覆盖三项内容:

  1. 问题追踪器(Issue tracker)——问题存放的位置。默认面向 GitHub,也支持 GitLab 和开箱即用的本地 Markdown。使用 to-issues、triage、to-prd、qa 等技能时会读取和写入它,它们需要知道应调用 gh issue create、在 .scratch/ 下写 Markdown 文件,还是遵循用户描述的其他工作流。

  2. Triage 标签词汇——五个规范角色使用的标签字符串:

    • needs-triage(维护者需评估)
    • needs-info(等待报告者)
    • ready-for-agent(已完成规格、可交由 AFK 智能体处理)
    • ready-for-human(需要人工实现)
    • wontfix(不予处理) 默认每个角色的字符串等于其名称。若仓库已有不同标签名(如 bug:triage 而非 needs-triage),可在此映射,避免重复创建。
  3. 领域文档(Domain docs)——CONTEXT.md 和 ADR 的位置及其读取规则。improve-codebase-architecture、diagnose、tdd 等技能会读取 CONTEXT.md 了解项目领域语言,并读取 docs/adr/ 了解既往架构决策。需确认布局为单上下文(仓库根一个 CONTEXT.md + docs/adr/)还是多上下文(根目录 CONTEXT-MAP.md 指向各上下文 CONTEXT.md,常见于 monorepo)。

使用方式

流程分为五步:

  1. 探索:读取 git remote -v 和 .git/config 判断是否 GitHub 仓库;检查根目录 AGENTS.md 与 CLAUDE.md 是否存在及是否已有 ## Agent skills 区块;检查 CONTEXT.md 与 CONTEXT-MAP.md;检查 docs/adr/ 及各 src/*/docs/adr/;检查 docs/agents/ 是否已有先前输出;检查 .scratch/ 是否已在使用本地 Markdown 约定。

  2. 展示发现并询问:总结已有和缺失内容,然后逐项引导用户完成三个决策,一次一节,不一次性抛出全部。假设用户不了解术语,每节先做简短说明。

  3. 确认并编辑:展示将写入的 ## Agent skills 区块草稿及 docs/agents/issue-tracker.md、docs/agents/triage-labels.md、docs/agents/domain.md 内容,供用户先行编辑。

  4. 写入:选择编辑文件——若 CLAUDE.md 存在则编辑它;否则若 AGENTS.md 存在则编辑它;若都不存在则询问用户创建哪一个,不要代为决定。绝不在此二者中已有一个存在时创建另一个。若所选文件中已存在 ## Agent skills 区块,则就地更新内容而非追加重复项,且不覆盖用户对周边段落的修改。随后依据技能文件夹中的种子模板写入三个文档文件:issue-tracker-github.md、issue-tracker-gitlab.md、issue-tracker-local.md、triage-labels.md、domain.md。对于“其他”问题追踪器,依据用户描述从零编写 docs/agents/issue-tracker.md。

  5. 完成:告知用户配置完成以及哪些工程技能将读取这些文件,并说明日后可直接编辑 docs/agents/*.md,只有需要切换问题追踪器或从头重来时才需重新运行本技能。

适用场景

适用于希望对工程类技能进行按仓库配置的代码仓库,尤其需要明确问题追踪位置、triage 标签映射或领域文档布局的项目。也适用于已有 .scratch/ 本地 Markdown 约定或使用特殊标签命名的仓库。

限制

本技能是提示驱动而非确定性脚本。其支持的默认问题追踪器为 GitHub,另支持 GitLab 与本地 Markdown;其他追踪器(Jira、Linear 等)需用户以一段文字描述工作流,技能将其记录为自由格式文本。关于收费、价格、平台兼容性或效果等信息,资料中暂未提供。