Agent Skills 规范要求技能目录至少包含 SKILL.md，脚本与参考资源则是可选部分；这说明它定义的是技能载体，不是完整开发编排。(Agent Skills 规范)
症状：你在比较两个名字，却把技能格式和工作流实现当成替代品。
最快解法：需要可复用、可迁移的指令时先用 Agent Skills；需要需求澄清、计划、测试和审查流程时再评估 Superpowers；两类需求都存在，就组合后验证当前 harness 的加载与工具能力。
谁该看这篇：需要在不同 AI 编程工具间复用技能的开发者，可用这里的检查项判断迁移边界。
想统一团队 Agent 流程的负责人，可据此拆开流程规则、技能文件与权限治理。
要持续运行编码任务的工程师，还应把环境隔离和会话维护纳入选择。
最后核对于 2026 年 9 月 25 日；信息核实自 Agent Skills 规范、Superpowers 官方仓库及其移植与技能说明。以下区分官方文档描述与团队实施建议，不代表 Macstripe 已完成跨 harness 实测。(Superpowers 官方仓库)
先按抽象层级拆开：格式与流程不是同类
Agent Skills 规定技能目录如何承载元数据、指令和可选资源。规范列出的目录形态包括 SKILL.md，以及可选的 scripts/、references/、assets/；其中 name 是必需字段，最长 64 个字符，description 必需且最长 1024 个字符。这些约束帮助你组织技能，却不会自动替你决定一项功能先做需求澄清还是先写代码。
Superpowers 则是建立在一组技能之上的软件开发方法与实现。其官方说明包含从头脑风暴、计划，到测试驱动开发、协作执行和代码审查等环节；它使用技能承载流程，所以和 Agent Skills 的文件结构有交集，但比较对象仍不处于同一抽象层。官方仓库的工作流清单也将头脑风暴、计划和执行等步骤列为不同技能。(Superpowers 官方工作流说明)
对你而言，关键差别不是谁“功能更多”，而是你需要哪种结果：
- ✅ 只想让 Agent 按团队规范处理某类任务：先写或采用符合规范的技能。
- ✅ 想让开发任务经过一致的设计、拆解、测试与审查：评估 Superpowers 这类流程实现。
- ⚠️ 想同时使用：要先解决技能触发重叠、指令冲突和工具权限边界。
再核对复用与迁移：文件相似不等于运行兼容
Agent Skills 的可迁移性首先来自目录结构约定，而不是“每个工具都自动支持”。规范定义 SKILL.md 的 YAML 前置信息与正文，并允许附带脚本、参考文档和资源；其中 allowed-tools 的支持可能因 Agent 实现而异。因此，目录能被复制，不代表目标 harness 会发现、读取、执行其中的脚本，或按预期解释所有元数据。
Superpowers 官方移植指南说明，不同 harness 的集成需要处理启动注入、技能调用与工具映射；指南还要求通过干净会话验收技能是否触发，并验证工具映射和集成测试。官方支持入口是判断依据，但不能据此推断任意工具、版本或自定义目录都能无改动运行。(Superpowers 官方移植指南)
技能目录中的脚本会引入额外的运行边界：目标环境可能缺少依赖，执行权限可能不同，或脚本能够访问不该交给 Agent 的文件。团队应在代码审查之外审查技能来源、脚本行为和最小权限；这是维护建议，不是 Agent Skills 格式本身自动提供的安全保证。OpenAI 的官方技能指南也提醒，使用技能前应审查技能及其支持文件，并考虑安全风险。(OpenAI 技能指南)
接着比较流程覆盖：它会教 Agent 做什么，也要看工具能做什么
Superpowers 官方工作流从设计讨论和计划推进到实现、测试与代码审查；其 TDD 技能要求先写测试、观察失败，再写最小实现并验证通过。子 Agent 开发技能还描述了分工与复核方式。它们是流程指令，不是测试框架、子 Agent 或终端权限的替代品。其官方计划技能也明确强调实现计划应包含需要修改的文件、测试和验证方式。(Superpowers 计划技能说明)
Agent Skills 也能封装多步骤流程。官方规范允许在正文写步骤、输入输出示例和边界情况，并用脚本或参考文件补充执行材料；但格式不会规定你必须进行需求澄清、TDD 或代码审查。技能可以记录完整流程，但是否执行仍取决于对应的运行方式和工具能力。
因此，流程覆盖要看实际能力，而不能只看技能文档写得多完整。若 harness 没有终端工具，测试驱动步骤可能停留在文字建议；若没有可用的子 Agent 能力，委派流程也可能退化为单 Agent 顺序执行。团队需要把“指令存在”与“动作成功发生”分开验收。
最后评估团队维护：把版本、来源和权限纳入日常流程
Agent Skills 的标准目录有利于把技能放入版本控制，但团队仍需自行约定版本固定、变更审查、依赖锁定和回滚方法。对脚本、资源引用和工具权限的检查同样不能只靠文件名判断。规范提到的 allowed-tools 不是跨实现统一的权限承诺，使用前要核对目标 harness 的实际支持。
Superpowers 的维护重点不同：除了更新技能文件，还要复核每种 harness 的安装、启动注入与工具映射是否仍有效。官方移植指南把干净会话验收、技能可调用和集成测试纳入完成条件；这说明“仓库里有技能”与“用户会话里能可靠触发”是两项不同的检查。
优点与代价：
- ✅ Agent Skills：目录可拆分指令和支持资源，适合共享单项知识或团队约定；代价是你要自行设计流程并验证不同工具的加载行为。
- ✅ Superpowers：提供面向开发任务的流程技能；代价是需要按 harness 处理集成，并确认相关工具和权限是否可用。
- ⚠️ 组合方案：覆盖面更完整，但重复触发、相互矛盾的规则与额外维护都是实际成本。
按需求走决策分支，再用小任务验收
- 若你主要需要跨项目复用代码风格、命令说明或领域知识，选 Agent Skills；否则转到下一条。
- 若你需要开发流程覆盖设计、计划、测试和审查，且 harness 提供所需工具，评估 Superpowers。
- 若团队同时需要通用技能与完整流程，可以组合；先限定两者各自负责的范围，再用验收任务确认没有重复指令。
- 若你要在多个 harness 间迁移，不要因一个工具运行成功就宣布全平台兼容；每个目标工具都独立验证发现方式、触发方式与工具映射。
可照着执行的小型验收：
- 准备：选一个隔离的测试分支和无敏感数据的小任务，记录 harness、技能来源、版本与加载路径。
- 检查发现：在新会话中询问 Agent 当前可用的相关技能；若工具有日志或插件状态信息，保存其加载证据。
- 检查触发：给出一个需求略有歧义、但影响范围很小的改动请求，确认 Agent 是否先执行预期的澄清或设计流程，而非直接改代码。Superpowers 的头脑风暴技能明确要求在实现前完成前置讨论，这类任务可用于检查触发顺序。(Superpowers 头脑风暴技能说明)
- 检查工具：要求完成一个可验证的小改动，确认它实际读取了项目文件、调用允许的命令并运行相关测试；只复述“会运行”不算通过。
- 检查结果：核对测试输出、差异和审查结论；记录未执行的步骤及原因，再对照该 harness 的官方支持文档决定是修正映射、调整技能还是放弃该组合。
以上流程是把官方移植指南中的验收要求转成团队可复用的记录，不是 Macstripe 的实测结果。发布前还应复核官方安装说明、支持的 harness 与加载路径；Superpowers 官方发布说明会记录文档和集成变更，若出现影响兼容判断的更新，应重新跑目标 harness 的验收任务。(Superpowers 官方发布说明)
常见选型疑问
独立 FAQ 已集中回答格式与流程的差异、Agent Skills 是否构成完整工作流、两者能否并用，以及换 harness 后如何确认技能已加载。实施时尤其要把“可发现”“已触发”“工具实际执行”“结果已审查”当作不同状态，不能只用安装成功替代验收。
选好技能后，再检查运行环境
如果你要把这套 AI 编程工作流用于持续任务，除了技能文件，还要评估项目隔离、终端权限、测试依赖和会话中断后的恢复方式。相较云端 Mac 环境，直接在个人电脑上长期跑任务会受到本地资源占用、开发环境污染和设备持续在线等限制；而远程环境若权限配置不当，也会扩大代码与凭据暴露面，因此应按项目敏感度设置隔离和访问范围。你可以先从 Macstripe 的云端 Mac 环境入口了解可用方案，并通过帮助中心核对远程使用与运维事项。
对短期试用、跨工具兼容验证或需要独立测试机的开发者，租用 Macstripe 的 Mac 环境能把验证环境与日常机器分开；如果你需要长期固定负载、必须连接特定物理设备，或希望完整掌控本机硬件，自购 Mac 往往更合适。决定租用前，先确认 Agent harness、项目隔离与访问权限需求，再把技能加载验收结果带进环境选择。
