312362115/claude/task-start

任务启动（Task Start）

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

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

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

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

快速判断信号：

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

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

对焦检查清单

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

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

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

来源 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 的状态：

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 追踪跨会话进度。

全系统项目强制规则

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