| name | task-start |
| version | 1.1.0 |
| last_updated | 2026-03-28T00:00:00.000Z |
| repository | https://github.com/312362115/claude |
| changelog | skills/task-start/CHANGELOG.md |
| description | 任务启动流程：需求对焦 + UI 原型确认 + 方案设计。收到新功能、复杂任务、大型需求时触发。 包含决策树判断走哪条路径、对焦检查清单、UI 原型预览环节、方案模板和示例。 触发词：新功能、实现xxx、大型任务、需求不明确。 工作流位置：task-start → task-execute → task-finish
|
任务启动（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 管理）
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 的状态：
- 找到
docs/backlog/ 中对应的需求文件，更新 frontmatter：status: in-progress
- 更新
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 或页面切换展示
- 风格：使用简洁的灰白配色即可，重点是结构而非美观
与用户对齐的要点
确认原型时，主动引导用户关注：
- 信息结构：页面上有哪些信息？层级对吗？有遗漏或多余吗？
- 布局方式：整体排列合理吗？关键操作位置顺手吗？
- 交互流程：用户完成核心操作的路径是否清晰？
- 状态覆盖：空状态、加载中、错误状态需要处理吗？
原型确认结论
## 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 时重点关注：
方案变更管理
开发过程中如果发现方案需要调整：
- 小调整（实现细节微调）：直接调整，在下次沟通时同步
- 中调整（步骤顺序变化、增删改动文件）：暂停开发，更新方案后继续
- 大调整（方向性变化、核心设计推翻）：停止开发，重新 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 |
