Superpowers技能框架深度配置指南定制你的AI开发工作流【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowersSuperpowers 是一套面向编码智能体的开发方法论框架核心由可组合的技能Skills和会话钩子Hooks会话关键节点自动执行的脚本构成。覆盖范围入口钩子配置、内置技能的调用与组合、运行时环境变量以及一条端到端工作流示例。H2 会话钩子工作流自动化的入口 ⚙️H3 钩子配置在哪改最小示例长什么样钩子定义在hooks/hooks.json。它注册了一个 SessionStart 钩子当会话启动、清空或压缩上下文时通过hooks/run-hook.cmd调用同名脚本hooks/session-start。SessionStart: [ { matcher: startup|clear|compact, hooks: [ { type: command, command: \${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\ session-start, shell: bash, async: false } ] } ]这个配置让框架在第一轮对话前就把skills/using-superpowers/SKILL.md的内容注入上下文所以技能无需手动触发也能被感知。H3 在此基础上加自己的自动化逻辑run-hook.cmd是一个跨平台多语言包装器Windows 下由 cmd 解析并找到 bashUnix 下按普通脚本执行找不到 bash 时静默降级。推荐在它后面追加自定义脚本两个典型场景会话开始时打印当前 git 分支与脏文件统计帮助智能体判断仓库状态在matcher中加入compact后执行上下文摘要脚本压缩上下文时保留关键约定修改后建议用tests/hooks/test-session-start.sh验证钩子输出仍是合法 JSON。H2 技能系统调用方式与内置能力清单H3 调用内置技能的两种方式会话钩子注入的规则要求只要有 1% 可能适用就必须调用技能。操作方式是让智能体执行 Skill 工具Use the Skill tool with skill name superpowers:brainstorming显式请求时直接指名即可。H3 高频技能一览brainstorming 从需求对话中提炼设计规格产出可评审的规格分块writing-plans 把批准后的设计展开成逐步实现计划subagent-driven-development 按计划逐任务派发子智能体执行并审查systematic-debugging 先定位根因再修复避免改完碰运气test-driven-development 红绿重构纪律测试先于实现using-git-worktrees 用工作树隔离开发环境避免分支互相干扰H3 技能之间的组合关系流程技能设定方法实现技能负责落地优先级上前者先于后者。subagent-driven-development 依赖 writing-plans 的产物其 SKILL.md 中声明superpowers:writing-plans - Creates the plan this skill executes即没有计划文档它无从执行。H2 运行时变量与插件扩展接口H3 必须知道的环境变量CLAUDE_PLUGIN_ROOT插件根目录钩子命令靠它定位脚本路径SUPERPOWERS_DISABLE_TELEMETRY设为任意真值关闭遥测默认只上报版本号不含项目内容DISABLE_TELEMETRY、CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICClaude Code 的既有退出开关框架同样遵守H3 扩展自己的工具除 Claude Code 外框架还支持 OpenCode、Codex、Gemini CLI 等十余种宿主。以 OpenCode 为例其插件机制是 JavaScript/TypeScript 形式提供事件钩子与自定义工具 API一个tool()注册即可向智能体暴露新能力。H2 完整工作流从需求到收尾的六步示例会话启动钩子注入技能索引智能体进入先问清意图模式触发 brainstorming 技能对话产出设计规格并逐块确认writing-plans 技能生成实现计划落盘为计划文档using-git-worktrees 创建独立工作树与主分支隔离subagent-driven-development 按任务派发子智能体test-driven-development 约束每个任务的测试先行遇到反复失败的测试systematic-debugging 接管定位根因任务完成后 finishing-a-development-branch 技能收尾分支维护建议自定义钩子脚本单独成文件hooks.json 里只改 command 引用便于回滚配置纳入版本控制团队共享同一套技能加载顺序改钩子后跑一遍tests/hooks/下的脚本确认 JSON 输出格式未破坏框架的完整设计文档在docs/superpowers/目录下的 specs 与 plans 子目录中记录了钩子、技能与宿主适配的实现取舍可按文件名中的日期定位演进脉络。技能行为以各skills/*/SKILL.md为准修改工作流前建议先读对应文件的最新版本。【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考