用途
该技能用于让 AI 在 Alan 环境中创建实施计划工件(implementation plan artifact)。其职责是分析问题并产出一份清晰、可执行的 Markdown 计划。
主要能力与工作方式
第一步是分析:阅读任务描述和任何关联上下文,探索代码库以理解架构、依赖、约束和风险,可自由使用 Read、Grep、Glob,但不得写入或修改任何文件。若属于修订请求(用户引用现有计划的反馈或提到某个计划工件),先用 mcp__alan__get_artifact 获取原计划,了解此前提出的内容。
第二步是澄清:起草前评估范围是否足够清晰,不清晰就提问,每次只问一个问题,而不是一次抛出十个问题;若问题可通过探索代码库回答,则应探索而非提问。若范围或需求确实不清,应直接说明需要更多澄清。任务描述详细、子任务清晰、存在相关文档且代码库探索已解答疑问时,可跳过澄清直接起草。
第三步是起草:以自然、自由的 Markdown 撰写计划,没有固定格式,可按问题选择步骤列表、分阶段依赖拆解、带权衡的决策树或逐文件变更清单等结构。计划应包含文件路径、函数名和相关理由,并可利用原生渲染的 mermaid 图辅助说明,例如用 sequenceDiagram 表达服务间交互与请求生命周期、erDiagram 表达数据库表与关系、flowchart TD 表达逻辑与流程、stateDiagram-v2 表达状态流转、C4Container 表达系统架构总览、flowchart LR 表达数据流。图应放在相关章节开头以建立上下文,涉及多组件或多服务时使用,简单变更不必画图。
第四步是持久保存:必须调用 mcp__alan__create_plan MCP 工具保存计划,否则计划会丢失。参数包括 title、content、summary、taskId、conversationId、teamId;任务 ID 可来自 ALAN_TASK_ID 环境变量,会话 ID 可来自 ALAN_SESSION_ID 环境变量,teamId 需先通过 Alan MCP 上下文/工具解析。三个 ID 必须显式传入,不可互相替代。保存后调用 ExitPlanMode 提交计划供用户审批,并以计划标题和工件链接(/teams/<teamId>/docs?artifactId=<artifactId>)开头呈现,不要以裸 UUID 开头,除非没有可用标题或链接时才作为次要调试信息。
反馈与修订
反馈被视为理解不完整的信号,而非简单补丁请求。应先理解每一点反馈(是纠正、担忧、缺失需求还是方向变化),有歧义先提问;再回到代码库重新分析,检查被反馈挑战的假设;然后基于更深理解重写计划,逐条明确回应反馈点并解释方法变化的原因。保存修订时使用同一标题并递增版本(如 Version 2、Version 3),将 parentId 设为上一版计划的工件 ID 以形成版本链并标记旧计划为 superseded,引用具体反馈点,若反馈含引用文本则回应相应章节。修订中可先用 mcp__alan__get_artifact 获取上一版完整内容作参考。
可用工具
mcp__alan__create_plan 用于持久保存新计划或带 parentId 的修订;mcp__alan__get_artifact 按 ID 获取现有计划/工件;mcp__alan__update_artifact 更新现有计划的内容/元数据;mcp__alan__add_artifact_comment 为计划工件添加评论;mcp__alan__resolve_artifact_comment 解决计划上的评论。
限制
不得写入或修改任何源文件,不得执行破坏性命令,不得跳过 create_plan MCP 调用,也不得使用固定的章节格式,应按最适合具体问题的方式自然表达。
适用场景
适用于在 Alan 平台中为开发任务制定实施计划、基于反馈迭代修订计划,并需要保留版本链与评论协作的工程规划场景。