estrutura-pastas-superpowers：为 AI 结对编程生成跨 Agent 项目脚手架与 SDD 目录结构

核心能力与快速开始

★ 0 · Shell

能做什么

通过 scripts/scaffold.sh 生成新项目脚手架：始终创建 .agents/（rules、context、skills、templates、agents）作为跨 Agent 事实来源，以及 docs/superpowers/（PRD.md、ADR.md、specs/、plans/）。按 --agents 生成入口文件：claude 生成 CLAUDE.md + .claude/（rules 以 symlink 指向 .agents/rules，含 settings.json 默认 deny .env*/*.pem/*.key）；grok/codex/cursor/kimi/cline/roocode 及任何未识别值生成 AGENTS.md 作为兼容回退；antigravity 不生成额外文件，直接读取 .agents/rules/。按 --lang 为 java、python、web、go、yaml、markdown、csharp、php、kotlin、rust、ruby 追加对应 .editorconfig 段落，每段引用官方风格来源。支持 --here 就地生成，逐项检查碰撞，一旦冲突即不移动任何内容并保留在临时目录；拒绝在目标不存在、不可写或指向 $HOME/系统根目录时运行。以 SKILL.md 形式提供 Claude Code 原生 skill，可链接为 /novo-projeto 命令。

适用场景

在启动新项目（尤其以 AI 结对编程为主的项目）时快速搭建统一的目录约定与跨 Agent 指令文件；在多个 AI 编码工具（Claude Code、Grok、Cursor、Codex 等）之间共享同一份规则与上下文；用 PRD/ADR/spec/plan 模板建立规范驱动开发流程；按语言生成有官方依据的 .editorconfig 缩进规则；作为 Claude Code skill 在会话中一键生成项目骨架。

项目形态

可直接使用的工具

部署方式

本地运行 Bash 脚本；可选通过 symlink 安装为 Claude Code 原生 skill（~/.claude/skills/）。官方未提供托管服务或云端部署说明。

主要依赖

需 git 与支持 bash 及 POSIX 工具（sed、ln -s、mktemp）的终端。Linux/macOS 通常自带；Windows 需 Git for Windows（Git Bash）或 WSL，且 .claude/rules 的 symlink 创建需开发者模式或管理员权限。许可证为 MIT。具体硬件与 API 成本未说明。

使用限制

官方明确该工具面向新项目，不适用于向已有项目注入结构（需手动复制模板），且默认拒绝写入已存在的同名子目录，绝不覆盖已有文件。Windows 原生 cmd/PowerShell 不可用；symlink 步骤依赖开发者模式或管理员权限，否则该步骤失败并回滚。--lang 未覆盖的语言仅生成基础 [*] 段。使用 --here 时需自行处理目标路径；官方提示 [diretorio-destino] 不做校验，若集成到第三方脚本/CI 中不应传入不可信外部输入。通过 Claude Code 使用时官方建议不要启用 --dangerously-skip-permissions。性能、规模与多 Agent 实际兼容性未经材料验证。

许可证

MIT

最近推送

2026-09-23 04:35

资料检查：2026-09-24 07:00 · 卡片整理：2026-09-24 09:00
卡片由 AI 根据仓库资料整理，未进行安装或运行验证 · 本次更新未完成，保留上次成功内容