KSCC Superpowers

KSCC 规范驱动工作流插件集，提供标准化的斜杠命令来支持构思、规划和执行工作流，以及前端组件库和代码影响分析能力。

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

功能

提供 4 个斜杠命令 + 1 个兼容别名和 3 个插件：

斜杠命令（kscc-spec 插件）

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

插件列表

1. kscc-spec - 基于 SPEC 规范驱动的 AI 代码开发插件
2. king-design - 基于 KING DESIGN 规范的前端组件库插件
3. frontend-change-impact - 基于 Git 变更分析的前端影响分析插件

安装与加载（插件模式）

本项目已切换为插件仓库模式，核心入口是：

• 插件市场：.claude-plugin/marketplace.json
• 插件目录：plugins/*

仓库内直接使用（推荐）

将本仓库作为插件源后，按市场配置加载以下插件：

1. kscc-spec（斜杠命令工作流）
2. kscc-design（KING DESIGN 组件库）
3. frontend-change-impact（前端变更影响评估）

插件结构约定

每个插件建议包含：

• .claude-plugin/plugin.json（插件元信息）
• skills/<skill-name>/SKILL.md（Skill 主入口，推荐）
• 可选：commands/、scripts/、evals/

兼容模式：仅安装斜杠命令

若你只需要 kscc-spec 的 4 个命令文件，仍可使用：

npx kscc-superpowers

或全局安装到 ~/.claude/commands/：

npx kscc-superpowers --global

工作流

1. 构思：使用 /brainstorm 探索想法，确定设计方案
2. 保存：使用 /save-design 保存设计到 docs/designs/
3. 计划：使用 /write-plan 创建详细的实施计划到 docs/plans/
4. 执行：使用 /execute-plan 按批次实施计划
5. 影响分析：使用 frontend-change-impact 插件分析代码变更影响

生成的目录结构

仓库结构示例：

kscc-superpowers/
├── .claude-plugin/
│   └── marketplace.json
├── plugins/
│   ├── kscc-spec/
│   │   ├── .claude-plugin/plugin.json
│   │   └── skills/  # Skill 主入口（brainstorm/write-plan/execute-plan/save-design）
│   ├── king-design/
│   │   ├── .claude-plugin/plugin.json
│   │   └── skills/king-design/SKILL.md
│   └── frontend-change-impact/
│       ├── .claude-plugin/plugin.json
│       ├── skills/frontend-change-impact/SKILL.md
│       ├── scripts/collect-impact-data.sh
│       └── evals/evals.json
└── docs/

命令详情

/brainstorm

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

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

/write-plan

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

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

/execute-plan

加载计划并分批次执行。

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

/save-design

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

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

插件系统

插件市场配置

插件市场配置位于 .claude-plugin/marketplace.json，定义了可用的插件列表：

| 插件名 | 路径 | 说明 | |--------|------|------| | kscc-spec | ./plugins/kscc-spec | 基于 SPEC 规范驱动的 AI 代码开发插件 | | king-design | ./plugins/king-design | 基于 KING DESIGN 规范的前端组件库插件 | | frontend-change-impact | ./plugins/frontend-change-impact | 基于 Git 变更分析的前端影响分析插件 |

king-design 组件库

提供 50+ 前端组件的使用示例：

| 类别 | 组件 | |------|------| | 基础 | Button, Icon, Grid, Layout | | 表单 | Input, Select, Form, Checkbox, Radio, Switch, DatePicker, TimePicker, Upload | | 数据展示 | Table, Tree, TreeSelect, Transfer, Pagination, Badge, Tag, Card, Descriptions, Timeline, Skeleton | | 反馈 | Dialog, Drawer, Message, Notification, Tooltip, Popover, Dropdown, Progress, Spin, Modal | | 导航 | Menu, Tabs, Steps, Anchor, Breadcrumb, BackTop | | 其他 | Affix, Carousel, Cascader, Code, Collapse, ColorPicker, Copy, Diagram, Divider, Editable, Ellipsis, Rate, ScrollSelect, Slider, Split, Tour, VirtualList |

frontend-change-impact 插件

基于 Git diff 进行前端影响面评估，支持：

• 上游视角：@{upstream}..HEAD
• 交付视角：<tag>...HEAD
• 双基线合并风险结论（私有化分支场景）

开发

项目结构

kscc-superpowers/
├── scripts/
│   └── install.js          # 安装脚本（支持 npx 和 postinstall）
├── plugins/                # 插件目录
│   ├── kscc-spec/          # SPEC 规范插件
│   │   ├── .claude-plugin/
│   │   │   └── plugin.json
│   │   └── skills/         # 技能（brainstorm/write-plan/execute-plan/save-design + tdd 等）
│   ├── king-design/        # KING DESIGN 组件库插件
│   │   ├── .claude-plugin/
│   │   │   └── plugin.json
│   │   └── skills/king-design/
│   │       ├── SKILL.md
│   │       └── examples/
│   │           ├── guide/      # 指南文档
│   │           └── components/ # 组件使用示例
│   └── frontend-change-impact/  # 前端影响分析插件
│       ├── .claude-plugin/
│       │   └── plugin.json
│       ├── skills/
│       │   └── frontend-change-impact/
│       │       └── SKILL.md
│       ├── scripts/
│       │   └── collect-impact-data.sh
│       └── evals/          # 评估数据集
├── .claude-plugin/
│   └── marketplace.json    # 插件市场配置
├── docs/
│   └── 使用与分享.md
├── package.json
├── index.js
└── README.md

插件开发规范

每个插件遵循 .claude-plugin/plugin.json 规范，至少包含：

• name: 插件名称
• version: 版本号
• description: 插件描述
• 可选：commands、skills 等扩展字段

Skill 使用方式

在支持 Skill 的环境中，可加载对应插件的 Skill，让 AI 主动把「斜杠命令」与「组件库」串成一条链：

• 新功能 / 新页面：建议先 /brainstorm → /write-plan → /execute-plan，执行到 UI 时使用项目组件库
• 直接使用组件：参考 king-design 插件的组件示例
• 分析代码变更：使用 frontend-change-impact 插件分析影响范围

许可证

MIT