AI 安装指令（变量 + 阶段门槛版）

0) 文档角色

• README.md 与 ./.trae/INSTALL.md 都是说明文件,不是脚本。
• 绝对禁止把 Markdown 文件当命令执行、手动运行项、搜索结果运行项或删除目标。
• 绝对禁止为了安装 Superpowers 再去克隆、拉取、同步或临时下载任何其他仓库。
• 绝对禁止创建任何 .tmp-*、tmp、temp、.cache 等临时目录。

1) 最小引导仓库结构

• 本引导仓库默认分支应只包含: ./.trae、./README.md、./LICENSE、./NOTICE.md、./.gitignore。
• fresh clone 场景下,还会额外存在 ./.git。
• 若某个 ./superpowers-trae 目录同时包含 ./README.md、./LICENSE、./NOTICE.md、./.gitignore、./.trae/,则它可以被识别为“引导仓库副本候选”。

2) 必须先定义的变量

• 在复制、删除、覆盖、注入记忆之前,必须先显式列出并确认以下变量:

- source_root - target_root - target_trae_path - memory_title

• 固定值:

- memory_title = "Superpowers 严格工作流约束"

• 若这四个变量中任意一个未明确,禁止进入下一阶段。

3) 根目录推导硬规则

• 第一步必须先列出“当前工作区根目录”的全部直接子路径,再推导变量。
• 仅允许以下三种已证明场景:

场景 A: bootstrap 模式

• 条件:

- 当前工作区根目录就是引导仓库根目录 - 当前目录可被100%确认是本仓库的 fresh clone - 直接子路径仅包含 ./.git、./.trae、./README.md、./LICENSE、./NOTICE.md、./.gitignore

• 变量:

- source_root = . - target_root = . - target_trae_path = ./.trae

场景 B: nested 模式,从目标项目根目录执行

• 条件:

- 当前工作区根目录中存在 ./superpowers-trae - ./superpowers-trae 符合上面的最小引导仓库结构

• 变量:

- source_root = ./superpowers-trae - target_root = . - target_trae_path = ./.trae

场景 C: nested 模式,但当前人正站在引导仓库子目录里执行

• 条件:

- 当前工作区根目录本身名为 superpowers-trae - 当前目录符合最小引导仓库结构 - 当前目录的父目录才是实际目标项目根目录

• 变量:

- source_root = . - target_root = .. - target_trae_path = ../.trae

• 若无法100%证明属于 A/B/C 任一场景,则根目录推导失败:

- 禁止复制 - 禁止删除 - 禁止注入记忆 - 只允许报告“根目录识别失败”

4) 路径自检门槛

• 进入复制阶段前,必须先完成以下自检:

- target_trae_path 必须是 target_root 下的 ./.trae - 在 nested 场景下,target_trae_path 绝对不能落在 source_root/.trae - 若 source_root 为 ./superpowers-trae 或当前目录名为 superpowers-trae,则 nested 场景的最终结果必须位于引导仓库目录之外

• 若路径自检失败,禁止进入复制阶段。

5) 阶段 1: 复制或刷新目标 .trae

• 安装源只能是 source_root/.trae
• 绝对禁止在线更新技能
• 绝对禁止创建临时目录
• 仅允许:

- 创建缺失的 target_trae_path - 刷新 target_trae_path/rules/superpowers.md - 补齐或刷新官方 skills - 保留用户自定义规则和不重名技能

• 在此阶段:

- 禁止删除 target_trae_path/INSTALL.md - 禁止删除 source_root - 禁止删除任何“引导仓库副本候选”

6) 阶段 1 自检门槛

• 复制或刷新后,必须立即验证:

- target_trae_path/rules/superpowers.md 存在 - target_trae_path/skills/ 存在 - target_trae_path/skills/ 至少包含: - brainstorming - systematic-debugging - test-driven-development - writing-plans - when-stuck

• 若上述任一项失败,禁止进入记忆注入阶段。

7) 阶段 2: 记忆注入 + 自检

• 只有阶段 1 自检通过后,才允许调用 manage_core_memory
• 记忆注入必须拆成三个可验证动作:

1. 删除同标题旧记忆 2. 添加新记忆 3. 立即做一次成功自检

• 记忆内容:

- 标题: Superpowers 严格工作流约束 - 关键词: superpowersworkflowtdddebuggingskills - 内容: 本项目严格遵循 obra/superpowers 开发方法论： 1. 功能开发必须先做设计与测试,遵循 brainstorming > using-git-worktrees > writing-plans > test-driven-development > code-review > finish-branch 的闭环。 2. 遇到报错或测试失败时,禁止猜测,必须调用 systematic-debugging 做根因排查。 3. 技能调用必须通过内置 Skill 工具真实执行。 4. 多步骤流程使用 TodoWrite。 5. 跨任务知识通过 manage_core_memory 沉淀。

• 记忆自检通过的判定:

- 工具返回成功,且标题与 memory_title 完全一致 - 若工具支持读取或确认,必须再做一次同标题确认

• 若记忆自检失败:

- 禁止进入清理阶段 - 禁止删除 target_trae_path/INSTALL.md - 禁止删除 source_root - 只允许报告“.trae 已安装,但记忆注入未完成”

8) 阶段 3: 清理阶段,仅在全部门槛都通过后进入

• 进入清理阶段前,必须同时满足:

- 路径自检通过 - 阶段 1 自检通过 - 记忆自检通过

• 以上三项缺一不可。

bootstrap 模式清理:

• 删除 ./.trae/INSTALL.md
• 再删除当前工作区内除 ./.trae 外的所有内容,包括 ./.git、./README.md、./LICENSE、./NOTICE.md、./.gitignore

nested 模式清理:

• 删除 target_trae_path/INSTALL.md
• 若 source_root 或 target_root/superpowers-trae 能被100%确认是引导仓库副本,则删除整个冗余 superpowers-trae 目录
• 旧失败流程残留的 ./.tmp-superpowers-* 可在最后尝试一次删除,但它们不是本流程创建的

9) 文件锁规则

• 若在清理阶段删除冗余副本或旧残留时遇到 Windows 文件锁:

- 不得再次修改 target_trae_path - 不得回滚已经安装好的 .trae - 直接报告残留路径 - 提示用户关闭占用程序或重启后手动删除

10) 完成判定

• 只有在以下条件同时成立时,才允许宣称“安装完成”:

- target_trae_path 位于正确的 target_root - target_trae_path/rules/superpowers.md 存在 - target_trae_path/skills/ 存在且包含核心技能 - 记忆注入自检通过

• nested 场景下,如果最终看到的是 superpowers-trae/.trae,而不是 target_root/.trae,则必须判定为“安装到错误目录”,不能宣称完成。