implementation-plan

实施计划

计划的作用不是证明你考虑到了所有事情，而是在仍可免费更改时，把那些可逆但代价高昂的决策摆到用户面前。排序应依据用户可能调整的概率，而不是构建顺序。

步骤

1. 开头用三行概述：要构建什么、选择了什么方案，以及风险最高的一项假设。
2. 第 1 节 — 你可能想调整的决策。 数据模型变更、新类型接口、API 形式，以及任何面向用户的内容。每项都说明所做的选择、考虑过的一个替代方案，以及日后更改它的代价。
3. 第 2 节 — 已知的未知因素及计划如何应对。 对于仍有歧义之处，说明将采用的默认方案，以及触发调整方向的信号。承认未知因素的计划才能经受现实检验；否则只会悄然失效。
4. 第 3 节 — 机械性工作。 重构、接线、迁移、测试。简要说明；用户信任你处理这些工作，审阅它们只会浪费用户的注意力。
5. 以审阅请求结尾：列出开始前需要用户明确回答是或否，或做出选择的 2-4 个具体事项。
6. 如果计划超过一屏，或用户更偏好视觉化材料，就将其提供为一个独立完整的 HTML 页面 — 各章节可折叠，可调整的决策固定在顶部。

注意事项

• 如果规划过程中出现明显更好的方案，应将调整方向作为一项独立决策提出 — 不要悄悄重新规划。
• 确保计划能在几分钟内审阅完。太长而读不完的计划会被草草浏览，而草草浏览的计划会掩盖糟糕的决策。
• 计划应为实施过程中的灵活应变留出空间；过度详细的计划恰恰会在现实与设想不符之处失效。