用途:为需要调研、设计判断、垂直切片或执行前安全计划的工作,创建或更新分阶段的规划产物。它不是一次性计划生成器,通常接收输入、执行或委托侦察、写出或修订当前阶段产物,然后在评审门停止,未获接受前不进入下一阶段。
主要能力:按阶段契约推进,包括研究问题、研究、设计讨论、结构大纲、最终计划;设计讨论承载开放与已解决问题,计划迭代更新计划本身。写作前加载相关来源:路线图条目、机会卡、架构候选、既有产物、coding-standards 技能、项目文档(AGENTS.md、README.md、CONTEXT.md、架构文档、ADR、验证配置、VCS 状态等)。
使用方式:默认选择能产生持久进展的最小阶段。若用户只说“规划这个”,通常从设计讨论开始,除非未知足够大需先写研究问题或研究。产物默认放在 .agents/plans/features/<feature-slug>/,含 README.md 索引与按时间顺序的 NNN- 产物;在 HumanLayer 任务内则用 .humanlayer/tasks/<task>/,并用 ls -La 检查目录(可能是符号链接),完整读取任务产物。每次调用通常只创建或更新一个主产物,可同时更新 README。
适用场景:需要研究、设计判断、垂直切片或执行前安全计划的复杂功能。
限制:研究阶段仅描述现状,不写建议;设计讨论需引用 coding-standards 相关关注点;各阶段需在评审门停止,除非用户明确要求继续;文档优先级为已接受计划 > 已接受结构大纲 > 已接受设计讨论 > 研究 > 来源路线图;草稿或评审中产物不覆盖已接受产物;若大纲或计划阶段出现设计分叉,应回到设计讨论。具体模板与示例见 references/artifact-templates.md 及 vendored HumanLayer v2 规划技能。