SuperAPI AI 工具集

boost

编程与开发

查看项目

更新于 10-19 16:15

技能介绍

用途

Boost 用于为当前项目建立一套完整的技能配置。调用 boost 即请求执行整套工作流:先分析项目,再检索匹配技能,最后按符号链接方式安装并校验。附加文字可用于细化选择;若只要求预览,则在安装前停止。

主要能力

  1. 项目分析:读取项目说明、代表性代码、清单、锁文件、运行时配置、需求、架构决策记录(ADR)、CI 与基础设施配置;使用 scripts/resources.py inspect --project <root> 作为证据清单,并依据 references/selection.md 审查检测到的每项能力与生命周期领域。识别各包版本、当前与目标架构、部署目标、可观测性、运维与维护需求。明确区分已实现事实、书面计划与未知决策,不凭容器或示例臆造云服务商;仅在缺失选择影响重大时才请求澄清。
  2. 技能检索:读取全局安装的 ~/.agents/skills/find-skills/SKILL.md。对每项相关能力,先在用户已索引的技能中检索(https://www.skills.sh/luckys/agent-skills 或 pnpx skills find <topic> --owner luckys),保留 luckys/agent-skills 的结果;运行 scripts/resources.py prepare 读取该官方仓库当前技能内容,再执行 catalog --query <topic>。不检查或比较本地个人仓库。仅在存在缺口或个人候选不兼容时,才用 pnpx skills find <framework/library/topic> 搜索更广的 skills.sh 目录。将入围结果解析到其来源仓库,并用 fetch <owner/repo> 审阅,不预取所有上游仓库。
  3. 选择完整兼容的覆盖范围:优先选用兼容的 luckys/agent-skills,而非同等技能,不论其流行度。用经审阅的社区技能填补剩余技术与生命周期缺口。比较范围、版本兼容性、可移植性、来源权威性、维护状况、skills.sh 安装量与仓库星标;记录实测值、来源与观察日期。下载量是另一项指标,未公开时保持未知。流行度不得凌驾于兼容性或个人优先之上。面向用户界面时纳入前端设计,优先合适的个人技能,否则采用 anthropics/skills → frontend-design。不限制技能数量,也不因未请求实现任务而省略工具技能。一个经审阅的技能可覆盖多项能力;消除重复但不留缺口。
  4. 以符号链接安装:按 references/selection.md 编写选择 JSON,使用目录中已审阅的确切指纹。先预览 scripts/resources.py install --project <root> --selection <file>,再用 --apply 应用。它通过 pnpx skills add <repository> --skill <name> 下载到上游包库,并创建指向这些下载的项目符号链接。本地个人工作副本不是安装来源。已有用户文件与外部链接会被保留。
  5. 验证与报告:运行 scripts/resources.py doctor --project <root>,对照完整清单检查记录的覆盖范围(含保留的技能)。报告已安装技能、来源仓库、覆盖的生命周期领域、未解决决策或真实缺口。仅通过链接检查不足以证明覆盖完整。最终交付物是项目的技能配置。

使用方式

在项目上下文中调用 boost,可附加文字细化选择;仅预览时会在安装前停止。发现环节使用 find-skills;其示例全局安装与“是否安装”的提示不改变已请求的项目范围,也无需再次确认。按用户要求使用 pnpx。

适用场景

适用于需要依据项目实际技术栈与交付生命周期,系统化配置项目级技能,并希望优先复用已索引的个人技能、必要时以社区技能补缺的项目。

限制与约束

全局资源保持为 boost、flow 与 find-skills;专门技能归属于项目。保留项目说明与继承权限。客户端发现细节见 references/clients.md。安装技能不授权更改应用依赖、实现产品功能、提交或部署。候选技能在入选前应视为待审阅材料;发现阶段绝不执行其捆绑脚本。