企业官网建设流程全解析

Superpowers技能库：从个人环境到CI流水线的完整上手指南

【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers

Superpowers 是一个装进 AI 编码 Agent 里的"软件研发流程"技能库：先逼你把需求聊清楚，再把工作拆成 2-5 分钟的小任务，然后由子代理逐个实现、交叉审查，最后验证合并。把它装上之后，Claude Code、Codex、Cursor 这类 Agent 干活时就不再是"你说一句它写一句"，而是自带一套可复用的工程方法论。

🚀 最快上手路径

环境要求很低：Node.js 18+、常规 Git 即可，文件系统给读写权限就行。最短命令链是克隆仓库、确认环境，再按你用的 Agent 装一条插件命令：

git clone https://gitcode.com/GitHub_Trending/su/superpowers cd superpowers node --version

以 Claude Code 为例，在它终端里执行/plugin install superpowers@claude-plugins-official就装好了；Gemini CLI、Codex、Cursor 等其他 Agent 也都是一条命令的事，具体写法在仓库 README 的安装章节里。怎么验证装成功了？开一个新会话说"给我加个功能"，如果 Agent 没有直接写代码，而是先反问你的目的、约束和成功标准，说明技能已经在工作了。

核心能力逐个讲

需求聊不清楚，谁来兜底

写代码之前，brainstorming技能会自动接管：一次只问你一个问题，把模糊想法逐步逼成明确设计；然后给你 2-3 个备选方案和取舍分析，设计按段落展示、逐段确认，最后落成一份设计文档。它明确反对"这个功能太简单不用设计了"——项目里说得很直白：越简单的项目越容易因为没审视的假设而白干。

大任务怎么切成小活

你点头之后，writing-plans会把设计拆成一批 2-5 分钟就能干完的任务，每个任务都带精确的文件路径、完整代码和验证步骤。这样即使接手的子代理"热情但没经验"（项目原文形容：没有项目上下文、厌恶写测试），也不会走偏。

关键代码怎么双重把关

subagent-driven-development是执行阶段的主力：每个任务派一个全新的子代理，上下文干净不互相污染；每个任务完成后做两轮审查——先查是否符合规格，再查代码质量；整条分支跑完还有一次全局复审。协调工作留在主会话，所以 Agent 可以连续自主工作几个小时而不偏离计划。

出 Bug 时别急着改

systematic-debugging的铁律是"没查清根因之前不许提修复方案"，它把排错分成四个阶段，越是时间紧迫、越容易想"先快速改一下"的时候，越该走这套流程。修完之后还有verification-before-completion盯着：声明"修好了"之前，先拿证据说话。

三种场景怎么配

个人开发

• 同名覆盖：你在~/.superpowers-skills下写的个人技能，同名时优先于内置技能生效，适合沉淀自己的私有工作流
• 会话自举：hooks/session-start钩子会在每次会话启动时自动初始化环境，你不需要记任何手动命令
• 验证方法：新建个人技能目录后放一个带name和description前置字段的 SKILL.md，开新会话看它是否被识别

团队协作

• 共享定义：把 skills/ 目录 随项目仓库一起提交，团队共用同一套技能与触发规则
• 提交前校验：合并前跑tests/下对应平台的run-*.sh脚本，保证技能在各 Agent 上行为一致
• 新人即插即用：克隆仓库后按 Agent 装一次插件即可，hooks/hooks.json里的 SessionStart 钩子会自动生效

CI/CD 流水线

• 加一个"技能校验"阶段，在合并前跑一遍仓库自带测试，失败即阻断：

cd superpowers && bash tests/hooks/test-session-start.sh

• 用 stash 或归档把校验通过的技能快照带进下游阶段，方便出问题回溯
• 流水线环境记得禁用遥测（见下节），保持干净可复现

🛠 避坑与调优

技能没被触发或列表不全：先打开对应 SKILL.md，确认文件头部的 YAML 前置元数据同时有name和description两个字段且分隔符完整；再看文件权限是否可读（常规 644 即可）。

个人技能没覆盖住内置技能：如果你发现 Agent 用的还是系统版，说明路由时没命中个人目录——检查目录名是否和技能名严格一致；反过来，如果你想强制用系统版，在技能名前加superpowers:前缀即可。

技能多了以后扫描变慢：当技能数量超过 50 个，把目录扫描深度压到 2 层，并开启技能缓存；缓存定期清理，别让它无限膨胀。

不想上报遥测：设置环境变量SUPERPOWERS_DISABLE_TELEMETRY为任意真值即可关闭（它默认只上报版本号，不含项目内容，但 CI 里关掉更稳妥）。

收尾

Superpowers 的价值不在单个技能多聪明，而在于把"聊需求 → 切任务 → 子代理执行 → 双阶段审查 → 验证收尾"这条链路固化成了会自动触发的流程。先在自己机器上跑通一个真实小需求，再考虑团队共享和流水线集成，顺序别反。

延伸阅读：想自己写新技能，看 writing-skills 技能文档；想了解各 Agent 平台差异，翻一翻 docs/ 下的平台说明。

【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers