93 lines
4.5 KiB
Markdown
93 lines
4.5 KiB
Markdown
# Blade Plan
|
||
|
||
SpringBlade 轻量规划执行工作流。将中等复杂度需求快速拆解为结构化任务，逐个执行，全程无辅助文件。
|
||
|
||
## 核心理念
|
||
|
||
**先想清楚，再动手写。** 面对涉及多个文件的改动，不急着写代码，而是先理清思路、拆好任务、确认方案，再逐个执行。用最小的流程开销，获得结构化开发的核心收益。
|
||
|
||
```
|
||
需求 → 分析规划 → 确认 → 逐任务执行 → 完成总结
|
||
```
|
||
|
||
## 快速开始
|
||
|
||
```bash
|
||
# 启动规划执行 — 展示方案后等待确认
|
||
/blade-plan 给 blade-starter-redis 新增分布式限流注解，支持按IP和用户维度限流
|
||
|
||
# 自动模式 — 展示方案后直接执行，不等待确认
|
||
/blade-plan --auto 重构 OssTemplate，将各厂商实现拆分为独立策略类
|
||
```
|
||
|
||
## 工作流程
|
||
|
||
**交互模式（默认）：** 展示规划方案后暂停等待确认，审批通过后开始逐任务执行。
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ │
|
||
│ 📋 分析与规划 │
|
||
│ 理解需求 → 扫描代码 → 制定方案 → 拆解任务 │
|
||
│ ↓ 用户确认 │
|
||
│ │
|
||
│ 🔨 逐任务执行（TaskCreate/TaskUpdate 追踪进度） │
|
||
│ Task 1 ✅ → Task 2 ✅ → Task 3 🔄 → Task 4 ⏳ → ... │
|
||
│ ↓ │
|
||
│ ✅ 完成总结 │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
**自动模式（--auto）：** 展示规划后直接开始执行，不等待确认。
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ │
|
||
│ 📋 分析规划 → 🔨 逐任务执行 → ✅ 完成总结 │
|
||
│ （展示方案后直接执行，不暂停） │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
## 适用场景
|
||
|
||
| 场景 | 适合 | 不适合 |
|
||
|------|------|--------|
|
||
| 新增中等功能模块（如限流注解、审计日志） | ✅ | |
|
||
| 跨多个文件的 Bug 修复 | ✅ | |
|
||
| 模块级重构（如拆分策略类） | ✅ | |
|
||
| 新增 Starter 模块 | ✅ | |
|
||
| 现有功能增强（添加新维度、新策略） | ✅ | |
|
||
| 单文件简单修改 | | ❌ 直接对话即可 |
|
||
| 快速问答或查询 | | ❌ 直接对话即可 |
|
||
| 从零开发完整业务系统 | | ❌ 建议拆成多次会话分阶段推进 |
|
||
| 需要先独立设计数据模型或跨服务契约 | | ❌ 先单独设计再进入 Plan |
|
||
|
||
## 复杂度分层
|
||
|
||
| 复杂度 | 文件变更量 | 建议方式 |
|
||
|--------|-----------|---------|
|
||
| 低 | 1~5 个文件 | 直接对话 |
|
||
| **中** | **5~15 个文件** | **Blade Plan** |
|
||
| 高 | 15+ 个文件 | 拆成多次会话，每次走一次 `/blade-plan` |
|
||
|
||
## 特性
|
||
|
||
- **零文件开销**：不生成任何辅助文件，规划在对话中展示，进度由内置任务系统追踪
|
||
- **上下文锚定**：每个任务执行前重读相关代码，防止偏离
|
||
- **构建验证**：每组任务完成后自动执行编译检查
|
||
- **技能协同**：自动识别可借助 `/blade-design`、`/avue-design` 加速的任务
|
||
- **智能降级**：过于简单时直接执行，复杂度过高时建议拆成多次会话
|
||
- **SpringBlade 体系适配**：内置 Boot / Cloud 分层最佳实践，同时可适配其他技术栈
|
||
|
||
## 文件结构
|
||
|
||
```
|
||
blade-plan/ # Skill 定义
|
||
├── README.md # 本文件
|
||
└── SKILL.md # Skill 主指令（全部内容，无 references 目录）
|
||
```
|
||
|
||
运行时不产生任何文件，所有状态由 Claude Code 内置任务系统管理。
|