技能介绍

多阶段 Skill 开发中的进度与决策缺失

在 Trae IDE 中开发多阶段 Agent Skill 时，随着流程复杂度的增加，常见的痛点包括：进度展示仅依赖纯文字描述、阶段过渡缺乏明确的进度更新提示、在需要用户决策的节点使用模糊的“等待用户确认”，以及多个 Skill 之间的工具调用风格不统一。这些问题会导致 Agent 交互缺乏连贯性，用户难以感知当前执行状态，也无法进行结构化的决策反馈。

标准化的工具嵌入模式

本 Skill 沉淀了将 TodoWrite 和 AskUserQuestion 嵌入现有 Skill 文件的最佳实践，通过明确的规范解决上述痛点：

TodoWrite 进度追踪：遵循粗粒度原则，在 SKILL.md 的入口处创建全局列表（使用 merge=false），并在每个阶段或确认点过渡时进行更新（使用 merge=true）。确认点需作为独立条目与阶段并列。
AskUserQuestion 结构化提问：仅在需要用户决策的确认点使用。要求一次性展示全部选项，并统一使用 question + header + options 的标准参数格式。选项设计需控制在 2-4 个，保证互斥且至少包含一个允许“调整/修改”的路径。
组合调用时序：在确认点处，先调用 AskUserQuestion 获取用户决策，随后更新 TodoWrite 状态，再进入下一阶段，确保进度与决策的同步。
自检与排错：提供嵌入前后的状态对照表和自检清单，并针对 merge 模式误用、粒度过细、选项不互斥等常见错误给出具体的恢复流程。

适用边界与注意事项

本指南的工具调用方式和文件结构约定基于 Trae IDE 的 Agent 交互规范。在将其迁移至其他 IDE 或平台时，需要根据目标环境的工具 API 进行适配调整。对于 2-3 步的短流程，仅使用 TodoWrite 即可，无需引入 AskUserQuestion。此外，为避免打断用户体验，单个 Skill 中的确认点建议不超过 3 个，若需更多则应考虑合并逻辑相关的确认点。