| .. | ||
| README.md | ||
| SKILL.md | ||
Blade Plan
SpringBlade 轻量规划执行工作流。将中等复杂度需求快速拆解为结构化任务，逐个执行，全程无辅助文件。
核心理念
先想清楚，再动手写。 面对涉及多个文件的改动，不急着写代码，而是先理清思路、拆好任务、确认方案，再逐个执行。用最小的流程开销，获得结构化开发的核心收益。
需求 → 分析规划 → 确认 → 逐任务执行 → 完成总结
快速开始
# 启动规划执行 — 展示方案后等待确认
/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 内置任务系统管理。