# Task Start

> >

- **Type:** Skill
- **Install:** `agentstack add skill-312362115-claude-task-start`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [312362115](https://agentstack.voostack.com/s/312362115)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [312362115](https://github.com/312362115)
- **Source:** https://github.com/312362115/claude/tree/main/skills/task-start

## Install

```sh
agentstack add skill-312362115-claude-task-start
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 任务启动（Task Start）

> 动手写代码之前，先确保"做对的事"（需求对焦）再"把事做对"（方案设计）。

---

## 第一步：决策树 — 这个任务需要走多深？

收到用户需求后，按以下决策树判断：

```
收到需求
  │
  ├─ 任务明确且改动 ≤2 个文件？
  │   └─ YES → 【直接动手】跳过本 skill，按 CLAUDE.md 基本流程执行
  │
  ├─ 任务有模糊点但规模不大（≤3 文件）？
  │   └─ YES → 【仅对焦】执行第二步的需求对焦，然后直接开发
  │
  ├─ 从头开发完整前后端系统 / 包含多个页面的项目？
  │   └─ YES → 【全流程强制】对焦 + UI 原型 + 方案 + task-execute + task-finish，每个环节不可跳过
  │
  ├─ 任务涉及 3+ 文件 / 新模块 / 技术选型 / 架构决策？
  │   └─ YES → 【对焦 + 方案】执行第二步 + 第三步（条件触发）+ 第四步
  │
  └─ 不确定？
      └─ 先花 2 个工具调用了解任务范围，再回到决策树判断
```

**快速判断信号**：

| 信号 | 路径 |
|------|------|
| 用户说"改一下xxx"、"加个xxx" | 大概率直接动手 |
| 用户说"实现xxx功能"、"帮我做xxx" | 大概率需要对焦 |
| 用户说"设计xxx系统"、"重构xxx" | 几乎肯定需要对焦 + 方案 |
| 用户说"做一个xxx系统"、"从头搭建" | **强制全流程：task-start(对焦+UI原型+方案) → task-execute → task-finish** |
| 用户描述中有"大概"、"类似"、"差不多" | 必须对焦 |

---

## 第二步：需求对焦（Align Before Act）

> 写代码之前先对清需求。主动问出来比猜错了返工成本低 100 倍。

### 对焦检查清单

在进入 Plan 模式或动手写代码之前，确认以下问题有答案：

| # | 问题 | 目的 |
|---|------|------|
| 1 | **核心目标**：这个需求解决什么问题？给谁用？ | 避免做出"技术上正确但用户不要"的东西 |
| 2 | **验收标准**：做到什么程度算"完成"？ | 防止过度实现或遗漏关键场景 |
| 3 | **输入/输出**：数据从哪来？产出是什么形式？ | 明确接口边界 |
| 4 | **边界与异常**：空值、并发、出错了怎么办？ | 提前识别隐藏复杂度 |
| 5 | **不做什么**：哪些看起来相关但这次不做？ | 划清 scope，防止膨胀 |
| 6 | **依赖与约束**：必须兼容的现有逻辑或技术约束？ | 避免做完发现不兼容 |

### 历史经验检索（对焦前必做）

在开始对焦之前，从两个来源检索历史经验：

**来源 1：docs/decisions/**（项目级经验，git 管理）
```bash
# 搜索相关关键词
grep -r "相关模块名/功能名" docs/decisions/
```

**来源 2：memory**（跨项目经验，跨会话索引）
- 读取 MEMORY.md 索引，检查有没有和当前任务相关的 feedback/project 类型记忆
- memory 中的信息可能已过期，引用前先验证（检查文件/函数是否还存在）

如果找到相关经验：
- **主动提醒用户**："上次做类似的事踩过这些坑：..."，标注来源（docs 还是 memory）
- 把历史经验纳入对焦考量，避免重复踩坑

如果没有找到：继续正常对焦。

### 如何对焦

- **不要一次问 6 个问题**：挑最不确定的 2-3 个，用 `AskUserQuestion` 确认
- **给出你的理解**：不是空泛地问"你想要什么"，而是说"我理解你要的是 X，边界情况我打算 Y 处理，对吗？"
- **信息够了就停**：80% 确定即可开始，剩下的在实现中验证

### 对焦对话示例

**差的对焦**（空泛、被动）：
```
用户：帮我加一个用户导出功能
Agent：请问你想导出什么？格式是什么？有什么要求？
```
→ 问题太散，用户不知道从哪答起

**好的对焦**（具体、主动给判断）：
```
用户：帮我加一个用户导出功能
Agent：我理解你要的是：
1. 在用户管理页面加一个"导出"按钮
2. 导出当前筛选条件下的用户列表，CSV 格式
3. 包含基本字段：姓名、邮箱、注册时间、状态

有两个点想确认：
- 导出数据量大吗？超过 1 万条的话需要考虑异步导出 + 下载通知
- 手机号等敏感字段需要脱敏吗？
```
→ 先给出自己的理解，再针对性问关键点

### 对焦结论输出

对焦完成后，把结论整理为一段话，格式：

```
## 需求对焦结论
- 目标：[一句话]
- 验收标准：[具体条件]
- 不做：[明确排除的内容]
- 待定：[开发中再确认的点]
```

这段结论直接输入到方案的"背景与目标"部分，或作为 Plan 模式的输入。

### 更新 Backlog 状态（对焦完成后必做）

对焦完成、确认启动开发后，**立即更新关联 backlog 的状态**：

1. 找到 `docs/backlog/` 中对应的需求文件，更新 frontmatter：`status: in-progress`
2. 更新 `docs/backlog/INDEX.md`：将该需求的 `[ ]` 改为 `[~]`

> 如果当前需求没有对应的 backlog 文件（比如临时小需求），跳过此步。

---

## 第三步：UI 原型确认（涉及前端页面时）

> 涉及 UI 的任务，写代码前先出可预览原型。改原型比改实现代码成本低 100 倍。

### 触发条件

**强制触发**（不可跳过）：
- 从头开发包含前端的完整系统
- 搭建新项目且包含多个页面

**条件触发**（涉及以下场景时执行）：
- 新建页面或视图
- 对现有页面做布局/结构性改动
- 涉及新的交互流程（表单、弹窗、步骤引导等）
- 用户明确提到了 UI 相关的期望

**不触发**：纯后端、纯逻辑、样式微调（改颜色/间距）、已有明确设计稿的任务。

### 执行流程

```
需求对焦结论
  │
  ├─ 涉及 UI？ → NO → 跳到第四步（方案设计）
  │
  └─ YES ↓
     1. 生成 HTML 可预览原型（静态页面，重点是布局和信息结构）
     2. 用 preview 工具启动本地预览，让用户在浏览器中查看
     3. 用户确认或提出修改意见
     4. 迭代调整，直到用户确认 UI 方向正确
     5. 将确认后的 UI 方案写入技术方案文档的「UI 设计」部分
```

### HTML 原型规范

- **目标**：验证布局、信息层级、交互流程，不追求视觉完美
- **技术要求**：单个 HTML 文件，内联 CSS，不依赖外部资源
- **存放位置**：`docs/prototypes/-prototype.html`，确认后可删除
- **内容要求**：
  - 使用真实的或接近真实的示例数据（不要 lorem ipsum）
  - 标注可交互元素的行为说明（hover 状态、点击跳转等）
  - 多个页面/状态用不同 section 或页面切换展示
- **风格**：使用简洁的灰白配色即可，重点是结构而非美观

### 与用户对齐的要点

确认原型时，主动引导用户关注：
1. **信息结构**：页面上有哪些信息？层级对吗？有遗漏或多余吗？
2. **布局方式**：整体排列合理吗？关键操作位置顺手吗？
3. **交互流程**：用户完成核心操作的路径是否清晰？
4. **状态覆盖**：空状态、加载中、错误状态需要处理吗？

### 原型确认结论

```
## UI 确认结论
- 页面结构：[确认的布局方案]
- 关键交互：[确认的交互行为]
- 用户反馈：[用户提出的调整及处理]
- 原型文件：[文件路径，供开发参考]
```

---

## 第四步：方案设计（Plan → Review → Do）

> 大型 feature 和复杂任务，写代码之前先写方案。改文档比改代码成本低 10 倍。
> 方案的具体写作由 **writing skill**（技术文档模式）负责，本步骤只负责流程调度。

### 方案产出流程

```
对焦结论就绪
  │
  ├─ 需要选型？→ 调用 tech-evaluation skill，获得选型结论
  ├─ 需要调研？→ 调用 deep-research skill，获得调研结论
  │
  ↓ 信息就绪
  │
  ├─ 写技术方案（spec）
  │   → 调用 writing skill（技术文档模式 → spec 模板）
  │   → 输入：对焦结论 + 选型结论（如有）+ UI 确认结论（如有）
  │   → 产出：docs/specs/YYYY-MM-DD--.md
  │   → 模板详见 writing skill 的 references/templates/spec.md
  │
  └─ 写开发计划（plan）
      → 调用 writing skill（技术文档模式 → plan 模板）
      → 输入：spec 文档
      → 产出：docs/plans/YYYY-MM-DD--plan.md
      → 模板详见 writing skill 的 references/templates/plan.md
```

### 方案内容要求

方案必须完整交代**背景→调研→验证→决策**全链路（详见 CLAUDE.md 方案设计规范）：

| 必备章节 | 必须回答的问题 |
|---------|--------------|
| 背景与动机 | 为什么要做？解决什么问题？ |
| 现状分析 | 当前怎么做的？痛点在哪？ |
| 调研与备选方案 | 调研了哪些方案？各自验证结果？ |
| 决策与取舍 | 选了哪个？为什么？放弃了什么？ |
| 技术方案 | 具体怎么实现？ |
| 风险与边界 | 已知风险？不做什么？ |

### Review 检查点

方案 Review 时重点关注：
- [ ] 目标清晰，验收标准可衡量
- [ ] 改动范围合理，没有 scope creep
- [ ] 技术选型有依据，不是拍脑袋
- [ ] 实施步骤可执行，有先后顺序
- [ ] 风险已识别，有应对方案
- [ ] 没有过度设计，复杂度与问题匹配

### 方案变更管理

开发过程中如果发现方案需要调整：
- **小调整**（实现细节微调）：直接调整，在下次沟通时同步
- **中调整**（步骤顺序变化、增删改动文件）：暂停开发，更新方案后继续
- **大调整**（方向性变化、核心设计推翻）：停止开发，重新 Review

---

## 与其他 skill 的衔接

```
task-start（本 skill）— 启动：对焦需求 + [UI 原型确认] + 设计方案
  │
  ├─ 对焦前 → 检索 docs/decisions/ 历史经验（避免重复踩坑）
  ├─ 对焦结论 → 输入到方案的背景部分
  ├─ UI 原型 → 调 rapid-prototype skill 或存入 docs/prototypes/
  ├─ 涉及选型 → 调 tech-evaluation skill
  ├─ 需要调研 → 调 deep-research skill
  ├─ 写方案 → 调 writing skill（技术文档模式 → spec 模板）
  ├─ 写计划 → 调 writing skill（技术文档模式 → plan 模板）
  ├─ 判定为重构任务 → 引导走 refactoring skill
  │
  ↓
task-execute — 执行：持续编码 + 跨会话进度管理
  │
  ↓
task-finish — 收尾：CR 自检
  ↓ （需求彻底完成后）
task-manager 标 done — 复盘 + 经验沉淀 → docs/decisions/
```

如果是跨多个会话的大型任务，同时使用 `task-execute` skill 追踪跨会话进度。

### 全系统项目强制规则

**从头开发完整前后端系统时，以下环节全部强制执行，不可跳过任何一个：**

| 环节 | skill | 必须完成的动作 |
|------|-------|-------------|
| 需求对焦 | task-start 第二步 | 对焦检查清单全部过一遍，输出对焦结论 |
| UI 原型确认 | task-start 第三步 | 生成 HTML 原型 → preview 预览 → 用户确认 |
| 方案设计 | task-start 第四步 | 完整方案文档，存入 docs/specs/ |
| 持续执行 | task-execute | 启用进度追踪框架，管理跨会话上下文 |
| CR 自检 | task-finish | 深度自检模式，逐项检查 |
| 复盘沉淀 | task-finish | 四维回顾 + 经验存入 memory |

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [312362115](https://github.com/312362115)
- **Source:** [312362115/claude](https://github.com/312362115/claude)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-312362115-claude-task-start
- Seller: https://agentstack.voostack.com/s/312362115
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.