【免费下载链接】superpowersAn agentic skills framework software development methodology that works - Claude Code task management support项目地址https://gitcode.com/gh_mirrors/sup/superpowers点击查看免费下载Superpowers是一个面向 AI 编码代理的技能框架agentic skills framework提供完整的软件开发方法论与 Claude Code 任务管理支持。它的贡献者指南 CLAUDE.md 开宗明义这个仓库有94% 的 PR 拒绝率而几乎所有被拒 PR 都来自没有阅读指南的 AI 代理。这篇文章带你逐条拆解这份反 AI 低质提交的贡献纪律给出新手提交第一个 PR 的实操清单。 94% 拒绝率从何而来AI 代理的slop洪水指南的第一句话就把 AI 代理叫停了CLAUDE.md#L3Stop. Read this section before doing anything.紧接着给出的事实相当扎心CLAUDE.md#L7这个仓库有 94% 的 PR 拒绝率。几乎所有被拒绝的 PR都是来自未阅读或未遵循这些指南的代理提交的。维护者会在几小时内关闭这些slopPR并留下类似This pull request is slop thats made of lies这是一个由谎言堆砌的劣质PR的公开评论。这里的关键词是slop低质内容。可以归纳出三个核心事实现象指南的态度被拒 PR 绝大多数由 AI 代理盲目执行任务产生不是代理犯错而是代理没读纪律低质 PR 浪费维护者时间、消耗贡献者信誉代理的职责是保护你的人免于这种尴尬CLAUDE.md#L9任何一项前置检查失败不要开 PR而是向人类解释为什么会被拒这份指南本身就是一项巧妙的行为塑造设计它放在仓库根目录CLAUDE.md 与 AGENTS.md 双份任何代理打开仓库的第一步就会撞上——纪律不是写给读者的文档而是写给代理的约束。️ 先认识 Superpowers它到底在管理什么提交代码之前先理解这个项目在做什么。Superpowers 通过一组技能skills把软件开发流程变成强制工作流头脑风暴 → 设计 → 写计划 → 派发子代理执行 → 测试驱动开发 → 代码审查 → 收尾合并。下面两张截图来自官方文档对比了无任务管理与启用扩展版任务管理时的 Claude Code 会话左原生版本中任务只存在于 markdown 计划文件里没有运行时可视化代理可能跳步、抢跑。右扩展版本中任务带依赖关系blockedBy、实时状态pending / in_progress / completed代理被钉在计划轨道上执行。这个设计哲学正是贡献指南的底色——流程优先于猜测证据优先于声明。理解了这一点你就能理解为什么指南对 PR 要求如此苛刻。✅ 提交 PR 前的 6 项强制检查指南要求代理在开 PR 之前必须完成六项检查CLAUDE.md#L11-L18缺一项就不要提交通读 PR 模板把 .github/PULL_REQUEST_TEMPLATE.md 的每个部分用真实、具体的内容填满不接受摘要和占位符搜索已有 PR包括 open和closed 的发现重复立即停止并告诉你的搭档确认这是真实问题如果搭档只是让你修修这个仓库而没体验过具体故障要反问他什么坏了哪里失败了确认改动属于核心库领域特定、工具特定的改动应做成独立插件表明身份在 PR 中披露模型、Claude Code 版本和所有已安装插件隐瞒代理身份直接是关闭理由把完整 diff 交给搭档获得明确批准后才可以提交 九类绝不接收的 PR 清单What We Will Not Accept 一节CLAUDE.md#L34列出了硬性红线新手提交前可以逐条对照类型为什么被拒第三方依赖Superpowers 是零依赖插件设计需要外部工具的改动应自建插件合规式技能改写技能内容经过实测调优按官方文档重排措辞必须附带充分的 eval 证据项目/个人专属配置只服务特定项目、团队、工作流的内容不属于核心批量扫射式PR拿着 issue 列表让代理批量修 → 一律关闭一次只深入解决一个 issue推测性/理论性修复我的审查代理标记了这里不算问题陈述必须描述真实会话或报错领域特定技能自问它对完全不同类型的项目有用吗没用的就单独发布Fork 专属改动不要向上游推 fork 同步、改名或特性捏造内容虚构的问题描述、幻觉出的功能 → 立即关闭捆绑无关改动一个 PR 只解决一个问题其余拆分值得玩味的是第 4 条指南明确反对让代理对着 issue 列表修东西这种用法。质量优先于数量这是对AI 代理刷 PR文化最直接的封杀。 拆解 PR 模板每一节在防什么完整模板见 .github/PULL_REQUEST_TEMPLATE.md每一节都是一道防线Who is submitting模型版本、执行环境harness、插件列表、人类审查者——贡献按产生方式分级评估基于真实会话的工作与基于文档推理的工作标准不同What problem模板直接警告——Improving something 不是问题陈述要写清楚什么坏了、代理的失败模式是什么最好附会话日志Existing PRs强制勾选项我审查了所有 open 和 closed PR若存在被关的同类 PR必须说明这次做法有何不同、为什么这次能成功New harness support新增 IDE/CLI 集成必须贴出干净会话的完整转录验收测试就是发送一句Lets make a react todo listbrainstorming技能必须自动触发——手动拷贝技能文件、运行时垫片都不算真集成Evaluation要求描述改动前后多个会话的对比结果It works不算评估Rigor技能改动必须声明经过对抗性压力测试Human review人类审查过完整diff 的勾选框不勾就STOP还有一个容易踩的坑所有 PR 必须指向dev分支而不是main——main是发布分支活跃开发先落dev。 技能不是文章是代码改动必须过 eval这是整份指南最有超前的部分。Superpowers 把 TDD测试驱动开发搬到了流程文档上完整方法论在 skills/writing-skills/SKILL.mdTDD 概念技能创作对应测试用例带子代理的压力场景测试失败RED没有技能时代理违反规则记录它找借口的原话最少代码只针对这些具体违规写技能测试通过GREEN有技能时代理遵守规则重构堵住新发现的借口并重新验证核心原则一句话如果你没亲眼看过代理在没有技能时失败你就不知道技能教对了什么。配套要求CLAUDE.md#L72-L83用writing-skills技能开发和测试改动跑多会话对抗压力测试PR 中展示 before/after 的 eval 结果不要修改经过精细调优的内容Red Flags 表、合理化借口清单、human partner 措辞——human partner 是刻意选词不是可以替换成 the user 的同义词行为 eval 由真实 tmux 会话驱动、LLM 验证器打分插件基础设施测试在 tests/claude-code/ 下可用 run-skill-tests.sh 运行 新手实操路径从理解到提交第一个 PRgit clone https://gitcode.com/gh_mirrors/sup/superpowers读懂项目按 README.md 走一遍基本工作流浏览 skills/ 下的技能库理解每个 skill 的SKILL.md如何塑造代理行为跑通测试熟悉 tests/claude-code/ 的测试组织方式技能测试用无头模式调用 Claude Code 验证行为选一个你真实遇到的问题指南反复强调——没有具体故障体验就不要动手。描述那次会话、那个报错、那个失败的用户体验按 writing-skills 流程开发先让代理在压力下失败RED再写最小改动GREEN再堵漏洞REFACTOR全程留证据填好模板、检查六项清单、指向dev分支把完整 diff 交给人类搭档审批后再提交结语拒绝率不是门槛是过滤器Superpowers 的贡献者指南值得所有使用 AI 代理做开源协作的团队参考它不劝退 AI 代理而是给 AI 代理立规矩——真实问题、可复现证据、人类知情、一次一问题。94% 的拒绝率挡掉的是slop留给认真者的通道从未关闭。赞分享【免费下载链接】superpowersAn agentic skills framework software development methodology that works - Claude Code task management support项目地址https://gitcode.com/gh_mirrors/sup/superpowers点击查看免费下载相关推荐superpowers-zh 贡献指南深度解读让 AI Agent 提交的 PR 不再被 94% 拒绝率拦下superpowers zh 贡献指南深度解读让 AI Agent 提交的 PR 不再被 94% 拒绝率拦下 本仓库的 CLAUDE.md https://lAI 技能AI 插件人工智能开发工具superpowers-zh 贡献指南深度解析AI Agent 如何提交不被拒绝的高质量 PRsuperpowers zh 贡献指南深度解析AI Agent 如何提交不被拒绝的高质量 PR 这篇技术指南以本仓库根目录下的 AGENTS.md httpsAI 技能AI 插件人工智能开发工具Superpowers 贡献者指南CLAUDE.md 中的 AI Agent PR 纪律、新 Harness 验收测试与 Eval 体系Superpowers 贡献者指南CLAUDE.md 中的 AI Agent PR 纪律、新 Harness 验收测试与 Eval 体系 SuperpowerAI 技能AI 插件开发工具创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考