用途
Skill Scout 用于为 AI 智能体当前正在工作的项目构建或更新项目专用的 kasetto.yaml。其目标始终是用户的活动项目根目录,而不是分发此技能的仓库。当用户要求侦察、查找、推荐、安装或更新项目专用技能时,应直接使用本技能;它是规范的工作流,不应绕道使用单独的 scout-skills 命令。
主要能力
- 确认目标项目:按 git rev-parse --show-toplevel、当前工作目录(非 Git 仓库时)、用户明确提供的路径的顺序确定活动项目根目录,并在写入文件前于工作笔记或最终回复中说明目标项目根目录。
- 构建设项目技术清单:在可用时运行
brief --json,但仅将其视为发现证据;对高价值发现须用清单文件(package.json、composer.json、pyproject.toml、Cargo.toml、go.mod、Gemfile、mix.exs 等)、框架配置(vite.config.、nuxt.config.、next.config.、tailwind.config.、terraform/**/.tf、wrangler.toml、sst.config. 等)、源码导入/使用、CI/部署配置以及必要时锁文件进行核实。每项技术需记录 technology、priority、evidence、reason。 - 技术优先级排序:P0 指塑造大部分实现工作的主框架/运行时/平台,必须研究技能;P1 指主要包、UI 系统、基础设施平台、测试栈或部署平台,必须研究技能;P2 指有用但次要的库/工具,仅在存在明显技能时研究;P3 指次要、传递性、附带或低影响项,除非用户要求否则忽略。高价值信号涵盖应用框架、CLI 框架、UI/设计系统、开发者平台和主要生态系统。当项目涉及前端、产品 UI、营销 UI、移动 UI、视觉重设计、Storybook 或 Figma 相关工作或设计系统工作时,可加入 Taste Skill 作为候选,但不得让纯设计候选挤掉更强的直接语言、框架、DevOps 或平台技能,且需先确认存在可用的 Kasetto 来源。
- 在线研究技能:对每个 P0/P1 技术,在有网络/搜索工具时至少使用两个外部发现来源,优先探测精选来源再回退到通用搜索。首选精选包为 Jeffallan/claude-skills,首选精选目录为 VoltAgent/awesome-agent-skills,还可使用 SkillsHub Resolve API、含 SKILL.md 的官方厂商/团队仓库、LobeHub Skills Marketplace、GitHub 代码搜索以及已安装的本地技能。每个候选需记录 name、technology、source_url、kasetto_source、source_type、adoption_signals(stars、last_updated)、evidence、trust、maintenance、fit、decision(add/defer/reject)与 reason。当无法识别 Git 或本地来源、来源为付费/不透明/私有/无溯源/未审计、技能通用且与更具体的可信技能重叠、宽泛或设计导向技能被可信精选或官方来源的直接技能压过、仓库疑似废弃或质量低下、或技能与已核实的 P0/P1 技术不明确匹配时,应拒绝或推迟候选。若在线搜索不可用,不得静默生成仅本地的配置,须报告限制并在继续前询问,除非用户明确允许离线模式。
- 可选发现工具:在可用时可使用 references/resolve-skillshub.sh、rg、fd、jq、yq、ast-grep/sg、Sourcegraph src CLI、repomix、semgrep。工具输出应视为证据而非最终真相;优先直接清单和框架配置而非宽泛源码匹配;有 ast-grep 时优先用于结构化检查而非正则。
- 规划 Kasetto 变更:读取现有 kasetto.yaml,保留有效的现有技能、agent、destination、scope、mcps、可行时的注释以及现有来源分组。默认形状为 agent: opencode、scope: project,skills 下列出 source 与 skills。若现有配置使用多个 agent,则保留该风格。规则包括:不重复来源块、不在同一来源块内重复技能名、按来源分组技能、除用户或现有配置要求外优先项目范围、仅在澄清来源或推迟人工审查时添加注释、不包含 Kasetto 无法同步的仅市场 URL、未经 --dry-run 不运行 kst sync。
- 校验:仅运行安全校验。当 kst 可用时运行
kst sync --config kasetto.yaml --dry-run,否则运行command -v kst || true并报告校验通过、失败或跳过。除非用户明确批准,不得运行真正的同步/安装。
使用方式
本技能直接响应用户关于侦察、查找、推荐、安装或更新项目专用技能的请求。子智能体策略:当宿主智能体支持子智能体或任务委派时,将其用于发现与研究;若子智能体不可用,则按相同角色顺序串行执行并在最终回复中说明。推荐角色包括 project-inventory(检查活动项目并识别经验证的技术)、skill-researcher(对 P0/P1 技术进行在线和本地研究)、kasetto-planner(将批准的候选转换为最小的 kasetto.yaml 补丁)、validator(仅运行安全校验命令)。当子智能体可用时 skill-researcher 阶段为强制;应从 agents/skill-scout-researcher.md 或等效的隔离研究工作器启动,而非在主智能体中完成所有在线研究。最终 YAML 编辑保留在主智能体中,除非宿主智能体具有可靠的补丁隔离。编辑配置前须阅读必需参考:brief-discovery.md(brief --json 发现)、scouting-workflow.md(项目检测与优先级排序)、online-research.md(强制在线技能研究)、kasetto-config.md(Kasetto 配置规则与示例)。
适用场景
适用于希望为当前活动项目自动发现、筛选并配置项目级 AI 技能的场景,尤其是用户提出侦察、寻找、推荐、安装或更新项目专用技能时。它强调基于证据的技术识别、对 P0/P1 技术的强制在线研究、以及生成仅含可同步 Git 或本地来源的最小 Kasetto 配置。
限制
- 目标始终是用户当前活动项目根目录,而非分发此技能的仓库。
- 仅写入符合 Kasetto 规范的 Git 或本地来源;不包含仅市场 URL(除非 Kasetto 能同步)。
- 未经用户明确要求,绝不运行真正的同步/安装。
- 在线研究不可用时不得静默生成仅本地配置,须报告限制并询问,除非用户明确允许离线模式。
- 可选发现工具缺失不会导致失败。
- 关于收费、价格、平台、具体效果或更详细的使用步骤,资料中暂未提供。