用途
tl-agent-plan-create 用于为功能、项目或多阶段任务创建结构化的计划文档。当用户要求“创建计划”或“规划”某项工作、启动新功能或项目、将复杂工作拆分为多个阶段，或提到“阶段”“里程碑”“路线图”时，可使用该技能。
主要能力
该技能产出位于 .cursor/plans/ 目录下的计划文档，包含 YAML frontmatter 和分阶段结构。它会确定计划类型、复杂度级别、依赖关系、问题跟踪集成以及文档范围。
计划分为两种类型：
- 战略型（Strategic）：高层阶段、里程碑、分组待办事项，适用于路线图或倡议概览。使用战略模板，每个阶段一个待办（分组），ID 为描述性 slug（如 phase1-foundation、gate-phase1），内容为描述阶段目标的短语，门禁为里程碑级别（非 bash）。
- 技术型（Technical）：细粒度子任务、每步一个待办、程序化门禁，适用于实现或重构。使用技术模板，每个原子子任务一个待办，ID 为 t{phase}-{group}-{step}，门禁为 gate-p{N} 或 gate-{描述性名称}。
使用方式
技能通过 AskQuestion 工具收集需求，尽可能在单一批次中提出所有问题。问题包括：
- 问题 0（最先询问）：计划类型是战略型还是技术型。
- 问题 1：计划名称/标题，选项包括新功能实现、第三方集成、重构或迁移、基础设施或 DevOps、其他。
- 问题 2：复杂度，选项包括小型（1-2 阶段，一天内完成）、中型（3-4 阶段，多天）、大型（5+ 阶段，一周以上）、由代理评估。
- 问题 3：依赖关系，是否依赖其他计划或工作。
- 问题 4（可选）：是否链接问题跟踪工单（如 JIRA、Linear、GitHub Issues）。
- 问题 5：是否会创建面向用户或开发者的文档。
- 问题 6：是否在功能分支中完成工作，若是则建议分支名 feat/{plan-name-kebab-case}。
文件命名约定为 {descriptive-name}-{8-char-hex}.plan.md，例如 quota-cycle-ground-truth-ccb07975.plan.md，采用 kebab-case 描述性名称加 8 位随机十六进制后缀，存放于 .cursor/plans/。
调用 CreatePlan 工具时，最重要的规则是：plan 参数必须以 H1 标题（# Plan Title）开头，且不得包含 --- frontmatter 围栏。工具会根据 todos 参数生成 frontmatter 并前置。
决策与验证要求
计划必须包含已决断的方案，而非开放问题。若遇到多种有效方法，规划者需阅读代码库理解现有模式与约定，应用第一性原理（关注点分离、SSOT、信息隐藏），评估哪种方法在结构上最合理、最具前瞻性且与现有架构一致，并在计划中确定一种方法并附一行理由。禁止出现未决备选方案（如“选项 A / 选项 B”“或者……”“另一种方法……”）、软性模糊表述（如“或等效”“大约”“应该”“更新相关文件”“如需要”）以及未经核实的事实性声明。
计划中关于代码库的每项事实性声明（文件存在性、导入者数量、“始终为 null”的断言、范围 grep、行号引用）都必须在计划正文的 ## Plan Metadata 部分的 ### Verifications 表中产生一行记录。验证提交 SHA 位于同一表的 Verified at 行。验证元数据不得放入 YAML frontmatter，因为 Cursor 的计划跟踪器拥有 .cursor/plans/ 下任何计划的 frontmatter，并在每次待办状态变更时重新序列化，会静默丢弃自定义键。正文不会被跟踪器重写，因此其中的记录得以保留。
状态生命周期
Plan Metadata 表中的 Status 行跟踪计划的整体状态，与单个待办状态分开。状态不得放入 YAML frontmatter。生命周期为：planned → audited → building → built。planned 由 tl-agent-plan-create 设置，表示计划已写好、所有待办待处理；audited 由 tl-agent-plan-audit 设置，表示计划通过审计、验证表已填充；building 由 tl-agent-plan-execute 设置，表示执行已开始、至少一个待办处于 in_progress；built 由 tl-agent-plan-execute 设置，表示所有待办已完成且所有退出门禁通过。执行者必须在相应转换时更新 Status 行。
实时更新与完成
在进入下一个子任务之前更新计划文件。技术型计划将待办状态从 pending → in_progress → complete 更新；战略型计划勾选 [ ] 框并更新 Plan Metadata 表中的 Status。切勿批量或延迟更新。计划完成时，验证所有门禁通过，将 Status 设为 built，并将文件移至 .cursor/plans/archive/ 文件夹。
适用场景与限制
该技能适用于需要结构化规划的功能开发、项目推进、多阶段任务、重构、集成、基础设施工作等场景。限制方面：计划必须使用纯 ASCII 待办内容，不得包含反引号、包裹引号或任何 YAML 指示符字符（冒号、#、!、&、*、|、>、%、@、花括号、方括号或前导 -/?）；阶段按前置条件排序；门禁为可运行的 bash 命令（技术型）或里程碑级别（战略型）。关于收费、价格、平台支持等具体信息，资料中暂未提供。