# progressive-sdd-init

**Repository Path**: asahi_software/progressive-sdd-init

## Basic Information

- **Project Name**: progressive-sdd-init
- **Description**: progressive-sdd-init 是一个 AI 辅助的项目初始化工具，专为 Superpowers SDD 渐进式开发流程设计。支持多种流行的 AI 编码工具，提供统一的技能和命令安装体验。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-04-16
- **Last Updated**: 2026-04-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI SDD 渐进式开发项目初始化工具

## 🚀 简介

`sdd-init` 是一个 AI 辅助的项目初始化工具，专为 Superpowers SDD 渐进式开发流程设计。支持多种流行的 AI 编码工具，提供统一的技能和命令安装体验。

## ✨ 特性

- **多 AI 工具支持**：Trae、Trae CN、Qwen Coder、OpenCode、Claude Code、CodeBuddy、Qoder
- **双安装模式**：项目目录（推荐）或全局目录
- **智能命令适配**：支持自定义斜杠命令的工具使用 slash-command，不支持的降级为 skill
- **code-copilot 模板**：自动拷贝到项目目录（已存在则跳过）
- **Token 消耗优化**：自动生成忽略规则，减少不必要的文件扫描
- **交互式引导**：友好的命令行界面，自动发现可用 skills 和 commands

## 📦 安装与使用

### 方式一：npx 一键执行（推荐）

无需安装，直接在项目目录中执行：

```bash
npx sdd-init
```

### 方式二：全局安装

```bash
npm install -g sdd-init

# 在项目目录中执行
sdd-init
```

## 🛠️ 支持的 AI 工具

| 工具 | 配置目录 | 技能目录 | 命令支持 | Token 优化配置 |
|------|---------|---------|---------|--------------|
| Trae | `.trae/` | `.trae/rules/` | 降级为 skill | `.trae/rules/ignore-patterns.md` |
| Trae CN | `.trae/` | `.trae/rules/` | 降级为 skill | `.trae/rules/ignore-patterns.md` |
| Qwen Coder | `.qwen/` | `.qwen/rules/` | 降级为 skill | `.qwenignore` |
| OpenCode | `.opencode/` | `.opencode/instructions/` | 支持 slash-command | `.opencodeignore` |
| Claude Code | `.claude/` | `skills/` (SKILL.md 规范) | 支持 slash-command | `.claude/settings.json` |
| CodeBuddy | `.codebuddy/` | `.codebuddy/rules/` | 支持 slash-command | `.codebuddyignore` + `config.yaml` |
| Qoder | `.qoder/` | `.qoder/instructions/` | 支持 slash-command | `.qoderignore` + `config.yaml` |

## 📁 包含的资产

### Skills（14 个 Superpowers Skills）
- brainstorming
- dispatching-parallel-agents
- executing-plans
- finishing-a-development-branch
- receiving-code-review
- requesting-code-review
- subagent-driven-development
- systematic-debugging
- test-driven-development
- using-git-worktrees
- using-superpowers
- verification-before-completion
- writing-plans
- writing-skills

### Commands（7 个 SDD 命令）
- `/propose` — 创建变更提案，生成渐进式 Spec
- `/apply` — 按确认后的 Spec 执行编码
- `/fix` — Review 后修正迭代
- `/review` — 两阶段代码审查（Spec 合规 + 代码质量）
- `/test` — 生成单测并执行 TDD 流程
- `/archive` — 归档变更并沉淀知识到知识库
- `/spec-init` — 初始化项目上下文，分析工程结构

### Code-Copilot 模板
包含完整的 AI 协作模板，包含 agents、changes、knowledge、rules 目录，支持 Java 后端项目的 SDD 开发流程。

## 🔧 技术栈

- Node.js 16+
- Inquirer（交互式命令行）
- Chalk（彩色输出）
- fs-extra（文件操作）
- YAML（配置解析）

## 📝 目录结构

```
sdd-init/
├── bin/             # CLI 入口
├── src/             # 源代码
│   ├── installers/  # 各 AI 工具安装器
│   ├── adapters/    # 格式适配器
│   └── utils/       # 工具函数
├── templates/       # 模板资产
│   ├── skills/      # Superpowers Skills
│   ├── commands/    # SDD 命令
│   └── code-copilot-template/ # Code-Copilot 模板
└── README.md        # 项目说明
```

## 🎯 使用流程

1. 在项目目录中执行 `npx sdd-init`
2. 选择要配置的 AI 工具（可多选）
3. 选择 skills 安装位置（项目目录/全局目录）
4. 选择要安装的 skills（自动发现）
5. 选择要安装的 commands（自动发现）
6. 确认是否复制 code-copilot 模板
7. 确认是否生成 Token 优化配置
8. 等待安装完成，查看安装报告

## 🔍 Token 优化配置

自动生成的忽略规则包括：
- `node_modules/`、`dist/`、`build/`、`.next/` 等构建产物
- `.git/`、`.svn/` 等版本控制目录
- `*.log`、`*.tmp` 等临时文件
- `*.min.js`、`*.min.css`、`*.map` 等压缩文件
- `package-lock.json`、`yarn.lock`、`pnpm-lock.yaml` 等锁文件
- `.idea/`、`.vscode/` 等 IDE 目录
- 以及其他常见的忽略模式（共 49 项）

## 📄 许可证

MIT