Plan/Code Workflow 是一套面向非平凡实现的工作流,把工作分成 Plan(分析/对齐)与 Code(执行计划)两种模式。
用途与复杂度评估:琐碎任务(简单语法、单一 API、少于 10 行)直接回答;中等任务(单文件内的非平凡逻辑、局部重构)使用 Plan/Code 工作流;复杂任务(跨模块设计、并发、多步迁移)必须使用该工作流。
通用规则:进入 Plan 模式时简要重述模式、目标、关键约束与当前状态;Plan 模式下必须先阅读相关代码再提出修改方案;仅在模式切换或约束显著变化时重述;不擅自引入范围外的新任务;当用户说“implement”“execute”“proceed”“start coding”时立即切换到 Code 模式。
Plan 模式:自顶向下分析,找根因而非只打补丁;列出关键决策点与取舍;提供 1 到 3 个可行方案,每个方案包含概要做法、影响范围(涉及模块/接口)、优缺点、潜在风险和验证方式;仅在缺失信息会阻碍进展时才提澄清问题;避免给出实质相同的方案。退出条件为用户明确选择某个方案,或某个方案明显更优(说明理由并主动选择),满足后直接进入 Code 模式。
Code 模式:主体必须是具体实现而非继续规划;提供代码前简要说明将修改哪些文件/模块及每处修改目的;优先最小化、可审查的改动,用局部片段/补丁而非完整文件,标出关键改动区域;说明验证方式(要运行的测试/命令),必要时草拟新测试用例;若发现重大问题则暂停并切回 Plan 模式。
输出应包含:做了哪些改动、在哪里;如何验证;已知限制或后续 TODO。
限制:资料未提供安装命令、收费信息、支持平台或具体示例代码。