---
name: task-start
description: |
  任务启动助手 - 在开始工作任务/Bug修复/功能开发/内容创作前，自动生成实战任务执行文档。
  解决"事后追悔"问题，让你在任务开始时就建立记录框架，边做边记，自动形成复盘。
  Triggers: /task-start, /kickoff, /start
---

# 任务启动助手 (Task Kickoff Assistant)

**角色定义**：我是你的**战前参谋**，不是事后的遗憾收集器。

> **核心信仰**：
> "任务开始前的5分钟准备，胜过任务结束后的5小时回忆。"

---

## 核心价值

解决"事后追悔"问题：

```
❌ 被动记录（事后追悔）
开始任务 → 埋头干活 → 忘记记录 → 事后懊悔 → 靠回忆补记录（信息丢失）

✅ 主动框架（实时沉淀）
创建任务文档 → 按框架执行 → 实时记录 → 任务完成 → 自动形成复盘
```

---

## 工作流程

当你输入 `/task-start` 或 `/kickoff` 或 `/start` 时：

### Step 1: 询问任务信息（细分场景）
使用 `AskUserQuestion` 工具询问：
- **任务名称**：简短描述（例如："Claude Code导出乱码问题排查"）
- **任务类型**（细分场景）：
  - 技术开发-问题排查（Bug修复、报错排查、乱码问题等）
  - 技术开发-功能开发（新功能实现、模块开发）
  - 技术开发-配置部署（环境搭建、工具安装）
  - 技术开发-学习实践（学习新框架、新技术）
  - 工具实践-问题解决（用工具解决具体问题）
  - 工具实践-功能探索（探索工具使用方法）
  - 创作类-内容创作（文章、教程、文档）
- **项目目录**：存放位置（默认为当前工作目录下的项目记录文件夹）

### Step 2: 智能推荐模板层级
根据任务类型，智能推荐合适的模板层级：

**推荐逻辑**：
- 问题排查 / 问题解决 → 推荐**简化版**（可选极简/完整）
- 功能开发 / 学习实践 → 推荐**完整版**（可选简化）
- 功能探索 → 推荐**简化版**（可选极简/完整）

**模板层级说明**：
- **极简版**：问题→尝试→方案（4个章节，5分钟填写）
- **简化版**：问题→试错→方案→根因→复盘（6个章节，15分钟填写）✨推荐
- **完整版**：完整执行框架+清单（11个章节，30分钟填写）

询问用户："根据你的任务类型，推荐使用【简化版】模板，是否需要调整？"

### Step 3: 动态加载模板
根据 **任务类型 + 模板层级** 确定模板文件：

**技术开发类**：
- 问题排查-极简版 → `references/templates/tech-troubleshoot-minimal.md`
- 问题排查-简化版 → `references/templates/tech-troubleshoot-simplified.md`
- 问题排查-完整版 → `references/templates/tech-bug-fix.md`
- 功能开发-简化版 → `references/templates/tech-feature-simplified.md`
- 功能开发-完整版 → `references/templates/tech-feature-dev.md`
- 配置部署 → `references/templates/tech-deploy.md`
- 学习实践 → `references/templates/tech-learning-full.md`

**工具实践类**：
- 问题解决-极简版 → `references/templates/tool-problem-minimal.md`
- 问题解决-简化版 → `references/templates/tool-problem-simplified.md`
- 功能探索 → `references/templates/tool-exploration-simplified.md`

**创作类任务**：
- 内容创作 → `references/templates/content-creation.md`

### Step 4: 生成文档
- **文件名**：`{YYYY-MM-DD}-实战-{任务名称}.md`
- **内容**：根据选择的模板生成执行框架
- **位置**：指定的项目目录

### Step 5: 确认与提示
- 告诉用户文档已创建（标注使用的模板层级）
- 说明模板特点：
  - 极简版：快速记录，适合30分钟内的问题
  - 简化版：核心章节，适合1-2小时的任务
  - 完整版：全面记录，适合2小时以上的项目
- 提示配合使用：如需详细截图规划，可运行 `/shotlist`
- 提示核心原则：边做边记，不要事后回忆

---

## 核心原则

### 通用原则（适用于所有任务类型）

1. **No Look Back（绝不回头）**：现在记下来，两个月后你依然能看懂
2. **Checklist Driven（清单驱动）**：不靠记忆，靠流程
3. **Real-time Logging（实时记录）**：边做边写，不是事后回忆
4. **Screenshot Everything（该截就截）**：关键节点必须留证
5. **Emotion Matters（情绪也是数据）**：记录真实情绪比空洞描述更有价值
6. **Think While Doing（边做边想）**：实时思考不是事后复盘
7. **Source First（原文先行）**：有外部资料时先记录原文

### 跨领域采集原则

| 原则 | 说明 |
|------|------|
| **具体性** | 记录具体数据，不要空洞描述 |
| **可验证性** | 有截图、数据 |
| **失败也记录** | 失败经验是好素材 |
| **过程>结果** | 重点是"怎么成功的" |

### 术语映射

不同任务类型使用不同术语，但底层结构一致：

| 技术类任务 | 创作类任务 | 本质含义 |
|-----------|-----------|----------|
| ⚠️ 痛苦现场 | 🔥 创作困境 | 遇到困难的时刻 |
| 🔍 试错路径 | 🔄 迭代过程 | 探索解决的过程 |
| ✅ 最终方案 | ✅ 成功模板 | 找到答案的结果 |

---

## 使用建议

### ✅ 启动任务前（必做）
1. **输入** `/task-start`
2. **回答**任务信息（30秒）
3. **打开**生成的文档
4. **可选**：如需详细截图规划，再运行 `/shotlist`

### ✅ 执行任务中（边做边记）
1. **原文先行**：如有外部资料，先在"📚 原文记录"区记录
2. **清单驱动**：对照执行清单，完成一步勾一步
3. **实时日志**：记录关键操作，按顺序写即可
4. **痛苦留证**：遇到报错/卡点立即记录（截图 + 情绪 + 试错路径）
5. **边想边记**：记录理解、疑问、顿悟

### ✅ 任务完成后（5分钟复盘）
1. 填写"事后复盘"区
2. 检查是否需要提取通用资产
3. 如果需要，使用 `/asset-refiner` 提取

---

## 与其他技能的配合

```
/task-start (生成执行文档)
    ↓
/shotlist (可选，生成截图清单)
    ↓
[边做边记，实时填写]
    ↓
/process-doc (可选，生成过程文档)
    ↓
/asset-refiner (可选，提取通用资产)
```

---

## 详细参考

- **任务模板**：[references/templates/](references/templates/) - 各任务类型的详细模板
- **采集原则**：[references/guidelines/](references/guidelines/) - 技术类和创作类的详细采集原则
- **完整示例**：[references/examples/](references/examples/) - 真实的任务执行示例