用途:这是一个严格的技能归属判定指南。每次创建或修改技能前都应使用该决策树,放错位置会导致技能在错误上下文中无法加载,或污染不应出现的上下文。
涉及包:ai-dev(代码质量、软件工艺)、agent-ops(智能体工作方式:评审流水线、研究、交接、编排)、shared(与领域无关的工具:pdf、html、浏览器、发布)、guitarizta(Guitarizta 业务、产品、知识库)、local(仅本机:VPS、发票、主机管理)、3p/<vendor>(第三方包,完整安装、永不编辑)、project(项目仓库中的 .kiro/skills/,仅该项目)。
决策树:第三方且非自有 → 3p/<vendor>/,用 APM 安装完整包并按智能体挑选;仅属于某个项目 → 提交到该项目仓库的 .kiro/skills/;关于智能体作为智能体如何工作(评审流水线、研究、交接、质询、编排、综合)→ agent-ops;任何领域智能体都可能用的工具(pdf 转换、html 报告、浏览器自动化、发布)→ shared;关于代码质量或软件工艺(git 约定、测试模式、安全、代码评审、前端标准)→ ai-dev;Guitarizta 业务/产品/知识库 → guitarizta;只在本机有意义(硬编码路径、主机专属服务、机器管理)→ local。
常用判定示例:critic-dialogue、research、handoff、grilling/grill-me、wayfinder、to-spec、to-tickets、prototype → agent-ops;markdown-to-pdf、publish-html-report、wizard、playwright-service → shared;git-commits、core-principles、tdd、pr-reviewer、pr-fixer、skill-writing → ai-dev;guitarizta-comms、crm、inbox-processing → guitarizta;aws-invoice-download、hermes-vps、meeting-recorder → local;grill-me (mattpocock) → 3p/matt-pocock。
Glob 规则:自有包在智能体 JSON 中用目录通配,第三方用精确路径,例如 "skill://~/.kiro/skills/ai-dev/*/SKILL.md"、"skill://~/.kiro/skills/3p/matt-pocock/grill-me/SKILL.md"。向自有包新增技能会被拥有该通配的智能体自动发现,无需更新智能体 JSON;新增 3p 技能则需把精确路径加到需要它的具体智能体。
编辑位置:ai-dev、agent-ops、shared、guitarizta、local 各自的 SKILL.md 路径,项目技能为 <project-root>/.kiro/skills/<name>/SKILL.md,3p 技能不得编辑、应从上游拉取。编辑自有仓库后直接推送 main,并同步到主机:cp "/Volumes/DATA EXT/Development/Repositories/__tools/<repo>/skills/<name>/SKILL.md" ~/.kiro/skills/<package>/<name>/SKILL.md。
3p 技能需要偏离时:复制到合适的自有包、自行编辑、从智能体 JSON 移除精确路径、若不再使用该包则从 APM 依赖中移除。
反模式:不要对 3p/ 使用通配,始终按精确路径逐个挑选;不要编辑 ~/.kiro/skills/3p/ 下的文件,apm update 会覆盖;不要把项目专属技能放进任何共享包;不要在 ai-dev 中加入引用 Guitarizta 专属路径的技能;不要在 ai-dev、agent-ops、shared 中硬编码机器路径。
限制:资料未提供具体安装命令、版本或收费信息,暂未提供。