KSCC Superpowers

KSCC 规范驱动工作流插件，提供标准化的斜杠命令来支持构思、规划和执行工作流。

📄 使用与分享文档：docs/使用与分享.md（背景、痛点、使用步骤、操作记录、FAQ）

功能

提供 4 个斜杠命令：

• /brainstorm - 构思设计，将想法转化为完整的设计方案
• /plan - 编写实施计划，创建详细的实现步骤
• /execute - 执行计划，按任务批次实现功能
• /save-design - 保存设计文档

安装

推荐：只安装命令文件，不写入 package.json 依赖

在项目根目录执行（不添加依赖，仅复制 4 个命令文件到当前项目）：

npx kscc-superpowers

全局安装：安装到用户主目录

安装到全局目录 ~/.claude/commands/，所有项目都可以使用：

npx kscc-superpowers --global
# 或简写
npx kscc-superpowers -g

可选：作为依赖安装

若希望把包加入项目依赖并在每次 npm install 时自动执行安装脚本：

npm install kscc-superpowers

安装后会在当前项目的 .claude/commands/ 下创建 4 个命令文件。

注意： 若目标文件已存在会跳过，不会覆盖。

若未自动生成 .claude/commands/ 或 4 个文件

在项目根目录执行：

npx kscc-superpowers

或（已安装为依赖时）：

node node_modules/kscc-superpowers/scripts/install.js

排查安装路径问题

若 npm install kscc-superpowers 后文件被装到 node_modules/ 下，可开启调试查看路径计算：

DEBUG=kscc* npm install kscc-superpowers

或：

KSCC_SUPERPOWERS_DEBUG=1 npm install kscc-superpowers

输出中的 projectRoot 即为脚本认定的项目根；若不是当前项目根，请把完整输出反馈给维护者。

工作流

1. 构思：使用 /brainstorm 探索想法，确定设计方案
2. 保存：使用 /save-design 保存设计到 docs/designs/
3. 计划：使用 /plan 创建详细的实施计划到 docs/plans/
4. 执行：使用 /execute 按批次实施计划

生成的目录结构

安装后，项目将包含：

your-project/
├── .claude/
│   └── commands/
│       ├── brainstorm.md
│       ├── write-plan.md
│       ├── execute-plan.md
│       └── save-design.md
└── docs/
    ├── designs/          # 设计文档（按需创建）
    └── plans/            # 实施计划（按需创建）

命令详情

/brainstorm

通过结构化问题将想法转化为设计方案。

• 逐个问题细化想法
• 探索 2-3 种不同方案
• 分段展示设计，逐步验证

/plan

创建详细的实施计划，假设执行者对代码库零理解。

• 每个步骤 2-5 分钟可完成
• 包含完整代码和验证命令
• 保存在 docs/plans/YYYY-MM-DD-<feature>.md

/execute

加载计划并分批次执行。

• 默认每批执行 3 个任务
• 批次间暂停等待反馈
• 严格按计划步骤执行

/save-design

将构思会话保存为设计文档。

• 分析会话内容推断主题
• 生成命名文件：docs/designs/YYYY-MM-DD-<slug>.md
• 结构化组织：上下文、讨论、方案、架构

开发

项目结构

kscc-superpowers/
├── scripts/
│   └── install.js          # postinstall 安装脚本
├── templates/              # 命令模板
│   ├── brainstorm.md
│   ├── write-plan.md
│   ├── execute-plan.md
│   └── save-design.md
├── package.json
└── README.md

许可证

MIT