Superpowers技能库完整指南3步完成部署与多场景配置【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowersSuperpowers 是一个面向 AI 编码代理的技能库和软件开发方法论。它让代理先澄清需求、再写设计、拆解计划后才动手写代码。本文带你走完三步部署并讲清楚个人、团队、CI 等不同场景下如何配置和排查 Superpowers 技能库。先说清楚编码代理为什么需要它 直接让 AI 代理写代码最常见的翻车方式是理解偏了需求、跳过测试、越写越跑偏。Superpowers 用一组可组合的技能来治这个毛病brainstorming 靠对话把需求问清楚writing-plans 把活儿拆成 2-5 分钟能完成的小任务subagent-driven-development 让子代理逐个执行任务并做两轮把关——先查是否符合规范再查代码质量。这里先解释一句所谓“技能”就是一张张可复用的指令卡每张教会代理如何完成某类特定任务。重点是这些技能会自动触发代理在动手前会先检查有没有适用的技能你不用记任何命令。效果上有据可查svelte-todo 实践中开发周期被拆成 12 个任务节点关键路径识别准确率 92%go-fractals 项目里审查环节找出 8 处内存泄漏代码覆盖率提升到 89%。三步完成环境部署 第一步克隆技能库git clone https://gitcode.com/GitHub_Trending/su/superpowers cd superpowers第二步核对环境基线三个前提条件Node.js v18 以上、Git 2.30 以上、文件权限不低于 755。缺哪个补哪个否则后面的技能扫描和钩子脚本都跑不起来。第三步验证技能加载node -e const core require(./lib/skills-core); console.log(core.findSkillsInDir(./skills, superpowers))输出里能看到至少 12 个技能定义、没有报错堆栈就说明部署可用。它到底怎么工作大白话版 技能发现扫目录建索引运行时用 findSkillsInDir 递归扫描 skills/ 目录把每个 SKILL.md 抓出来读取文件头部的 YAML 前置元数据——就是文件开头两段---之间、记录 name 和 description 的那块小字段——然后建好技能索引。代理靠这份索引判断当前任务命中了哪个技能。优先级路由项目盖过个人个人盖过默认同名技能同时存在时resolveSkillPath 按优先级做路由项目专属技能排最前个人扩展技能居中基础技能库垫底。也就是说团队定制能盖过你的个人定制你的个人定制又能盖过出厂默认。会话启动钩子与自动更新钩子hook是定时自动执行的脚本。hooks/hooks.json 里注册了 hooks/session-start每次开发会话启动时它负责完成环境初始化checkForUpdates 还会顺带检查技能库有没有新版本可拉取。不同场景怎么配 ⚙️个人开发用个人技能覆盖默认建一个~/.superpowers-skills目录再软链到项目里的 personal-skills往里面放同名技能就能覆盖基础库。一行命令验证路由结果node -e console.log(require(./lib/skills-core).resolveSkillPath(my-custom-skill, ./skills, ./personal-skills))团队协作共享技能目录直接把 skills/ 目录共享给所有人再跑 tests/ 目录下的验证脚本保证每份技能内容一致。团队协作建议再配置 hooks/hooks.json在提交前加一道技能校验。CI/CD流水线加一步校验在 Pipeline 里加一个 shell 步骤执行 tests/explicit-skill-requests/run-all.sh 技能测试脚本任何技能不一致都让流水线变红把问题拦在合并之前。技能加载失败排查清单 技能列表缺失或不全按顺序查三处文件权限ls -la skills/确认每个 SKILL.md 权限不低于 644元数据分隔符grep -r ^---$ skills/YAML 开头结尾的---缺一段都会解析失败跑一遍诊断脚本bash tests/opencode/run-tests.sh拿到详细错误报告再对症下药个人技能没有生效多半是优先级被抢了。想强制用基础库技能加superpowers:前缀例如 superpowers:brainstorming即可想让个人技能占上风确认项目里没有同名技能抢先或把冲突的个人技能目录改名挪走。进阶建议性能调优与技能编写规范 ✨技能数量多时先看三个参数技能超过 50 个时先开启缓存export SUPERPOWERS_CACHE_SKILLStrue再按场景调下面三个参数timeout默认 3000 毫秒控制 git 更新检查超时网络差的环境调到 5000cacheTTL技能缓存过期时间默认 3600 秒开发环境用 60 秒让改动快速生效生产环境用 86400 秒maxDepth目录扫描深度默认 3个人环境建议 2团队环境建议 4想极致压缩就限到 2配合得当技能加载速度能提升 40-60%。自己写技能要守住的三条线每个 SKILL.md 必须同时有 name 和 description 两个字段否则根本不会被发现正文按“触发条件—执行流程—输出格式”三段式来写每个技能在 tests/explicit-skill-requests/prompts/ 下配至少 2 个测试用例完整编写指南见 skills/writing-skills/SKILL.md先把部署和场景配置跑通再按上面的参数调优代理就能稳定按流程干活。等这套工作流跑顺了你还可以照着 writing-skills 继续扩充自己的技能库。【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Superpowers技能库完整指南：3步完成部署与多场景配置
Superpowers技能库完整指南3步完成部署与多场景配置【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowersSuperpowers 是一个面向 AI 编码代理的技能库和软件开发方法论。它让代理先澄清需求、再写设计、拆解计划后才动手写代码。本文带你走完三步部署并讲清楚个人、团队、CI 等不同场景下如何配置和排查 Superpowers 技能库。先说清楚编码代理为什么需要它 直接让 AI 代理写代码最常见的翻车方式是理解偏了需求、跳过测试、越写越跑偏。Superpowers 用一组可组合的技能来治这个毛病brainstorming 靠对话把需求问清楚writing-plans 把活儿拆成 2-5 分钟能完成的小任务subagent-driven-development 让子代理逐个执行任务并做两轮把关——先查是否符合规范再查代码质量。这里先解释一句所谓“技能”就是一张张可复用的指令卡每张教会代理如何完成某类特定任务。重点是这些技能会自动触发代理在动手前会先检查有没有适用的技能你不用记任何命令。效果上有据可查svelte-todo 实践中开发周期被拆成 12 个任务节点关键路径识别准确率 92%go-fractals 项目里审查环节找出 8 处内存泄漏代码覆盖率提升到 89%。三步完成环境部署 第一步克隆技能库git clone https://gitcode.com/GitHub_Trending/su/superpowers cd superpowers第二步核对环境基线三个前提条件Node.js v18 以上、Git 2.30 以上、文件权限不低于 755。缺哪个补哪个否则后面的技能扫描和钩子脚本都跑不起来。第三步验证技能加载node -e const core require(./lib/skills-core); console.log(core.findSkillsInDir(./skills, superpowers))输出里能看到至少 12 个技能定义、没有报错堆栈就说明部署可用。它到底怎么工作大白话版 技能发现扫目录建索引运行时用 findSkillsInDir 递归扫描 skills/ 目录把每个 SKILL.md 抓出来读取文件头部的 YAML 前置元数据——就是文件开头两段---之间、记录 name 和 description 的那块小字段——然后建好技能索引。代理靠这份索引判断当前任务命中了哪个技能。优先级路由项目盖过个人个人盖过默认同名技能同时存在时resolveSkillPath 按优先级做路由项目专属技能排最前个人扩展技能居中基础技能库垫底。也就是说团队定制能盖过你的个人定制你的个人定制又能盖过出厂默认。会话启动钩子与自动更新钩子hook是定时自动执行的脚本。hooks/hooks.json 里注册了 hooks/session-start每次开发会话启动时它负责完成环境初始化checkForUpdates 还会顺带检查技能库有没有新版本可拉取。不同场景怎么配 ⚙️个人开发用个人技能覆盖默认建一个~/.superpowers-skills目录再软链到项目里的 personal-skills往里面放同名技能就能覆盖基础库。一行命令验证路由结果node -e console.log(require(./lib/skills-core).resolveSkillPath(my-custom-skill, ./skills, ./personal-skills))团队协作共享技能目录直接把 skills/ 目录共享给所有人再跑 tests/ 目录下的验证脚本保证每份技能内容一致。团队协作建议再配置 hooks/hooks.json在提交前加一道技能校验。CI/CD流水线加一步校验在 Pipeline 里加一个 shell 步骤执行 tests/explicit-skill-requests/run-all.sh 技能测试脚本任何技能不一致都让流水线变红把问题拦在合并之前。技能加载失败排查清单 技能列表缺失或不全按顺序查三处文件权限ls -la skills/确认每个 SKILL.md 权限不低于 644元数据分隔符grep -r ^---$ skills/YAML 开头结尾的---缺一段都会解析失败跑一遍诊断脚本bash tests/opencode/run-tests.sh拿到详细错误报告再对症下药个人技能没有生效多半是优先级被抢了。想强制用基础库技能加superpowers:前缀例如 superpowers:brainstorming即可想让个人技能占上风确认项目里没有同名技能抢先或把冲突的个人技能目录改名挪走。进阶建议性能调优与技能编写规范 ✨技能数量多时先看三个参数技能超过 50 个时先开启缓存export SUPERPOWERS_CACHE_SKILLStrue再按场景调下面三个参数timeout默认 3000 毫秒控制 git 更新检查超时网络差的环境调到 5000cacheTTL技能缓存过期时间默认 3600 秒开发环境用 60 秒让改动快速生效生产环境用 86400 秒maxDepth目录扫描深度默认 3个人环境建议 2团队环境建议 4想极致压缩就限到 2配合得当技能加载速度能提升 40-60%。自己写技能要守住的三条线每个 SKILL.md 必须同时有 name 和 description 两个字段否则根本不会被发现正文按“触发条件—执行流程—输出格式”三段式来写每个技能在 tests/explicit-skill-requests/prompts/ 下配至少 2 个测试用例完整编写指南见 skills/writing-skills/SKILL.md先把部署和场景配置跑通再按上面的参数调优代理就能稳定按流程干活。等这套工作流跑顺了你还可以照着 writing-skills 继续扩充自己的技能库。【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考