code-development

Code Development

目标是在保持用户已有工作和现有正确行为的前提下，把真实问题转化为经过设计、实现、独立评审和实际验证的可用结果。不同代码任务沿同一条主干推进：

理解问题与工程环境
→ 设计并消除关键未知
→ 小批量实现和真实集成
→ 独立评审与分层验证
→ 交付、观察和迭代

主干顺序保持稳定，执行深度随风险和未知变化。明确、低风险的局部修改可以在一次调查、修改和验证中走完。陌生平台、外部依赖、跨模块功能和难以回滚的改动需要明确完成各阶段。流程用于提高正确性，不为通过阶段制造无用文档、测试或仪式。

理解问题与工程环境

从用户要获得的结果和可观察验收路径开始，确认修改范围、必须保持的行为和当前事实。以当前代码、配置、测试和实际运行结果为准，沿最相关的入口、调用关系、数据流、依赖和已有实现建立足以支持本次决定的系统模型。区分已经证实的事实、合理推断和会改变路线的未知。

在宿主平台、框架、API 或第三方依赖上开发时，把它们视为工程环境的一部分。需要时核实当前版本的官方文档、源码、示例、发行记录和真实加载行为。不能控制的上游行为不凭记忆假定。已经能够说明代码从哪里进入、怎样与现有系统交互、结果如何观察，而且剩余未知不会改变实现路线时，停止扩展调查。

仍有会推翻总体方案的未知时，继续只读调查或做只回答该问题的最小风险实验。实验结果足以选择路线后进入设计。静态推测、mock 成功和代理指标不能代替任务要求的真实系统证据。

扩大实现、专项研究、独立评审或成套测试前，先确认本次改动经过现有系统的哪个真实入口，以及它将改变哪项用户结果。尚未确认时，继续项目调查或做只回答这个问题的最小验证。

仍有会改变 demo、工作路线或明显投入的核心价值、使用体验、成品形态或验收取舍，而且上级合同和当前项目证据都没有给出答案时，当前代码阶段不通过实现猜测用户偏好，把具体差异、已有证据和实际影响交回上级。

安全、权限和边界问题由当前代码、即将执行的具体行动或合同要求触发。没有实际触发依据的风险保留为待验证假设，不把它扩展成专项架构、研究或验证，也不用它替代对现有系统的理解。

证明路线，而不是维护路线

把用户问题、可观察结果与当前实现路线分开。框架、架构、库和工具是待验证的解决假设。除非用户或既有系统明确要求，不因已经写了代码或解决了若干路线内问题而变成必须保持的目标。新问题出现时，先判断它是目标本身需要完成的工作、可行路线内的普通缺陷、证据缺口，还是当前路线制造的结构性负担。

跨层、陌生、高成本、批量或难以回滚的路线在扩大实现前，先找出最可能否定它的用户结果，并用最小真实切片验证。最小端到端路径只证明入口和数据链能够连通，不自动证明产品方向成立。例如桌面界面的窗口启动不能代替代表性截图、交互、刷新和资源体验。语义迁移的事务成功不能代替高风险内容样本和真实检索或使用效果。样本按本任务风险选择，不把这些例子机械套到无关任务。

路线能够运行也可能已经失效。过程指标通过而代表性用户结果失败或长期未知、同一路线反复要求跨组件补偿或重建成熟平台已有能力，或者剩余工作的主体已变成维护路线自身且成本相对成熟替代明显失衡时，停止扩大投入。先做一个能区分局部缺陷与结构错配的最小实验。证据足够后按用户结果、剩余成本、风险、验证路径、可复用资产和切换代价比较继续、缩小或换路。既有投入是沉没成本，不作为继续理由，已经可靠工作的可复用部分单独保留。

路线仍有会改变方向的未知时，优先采用连续的小步试探，不把完整实现当作第一次实验。每一步应当小而真实、容易观察和尽可能可撤销，专门减少一个会改变路线的未知。开始前明确本步要回答的问题、使用的真实路径或代表性数据、支持继续与触发调整的判据，以及它与最终系统仍有什么差异。取得反馈后更新当前模型，再决定扩大、调整、补证据或换路。小步按决策信息划分，不按文件或命令机械切碎，也不要求把每次试探都变成对用户的进度汇报。路线和验收已经清楚的普通局部工作可以直接完成，不为形式增加试探。

先交付最小核心成品

对于陌生、跨层、高成本、依赖真实宿主或外部服务，或者已经出现代表性结果不推进的路线，第一次实现先交付一个最小核心成品，也就是 demo。它保留用户需求中不能缺少的核心价值，让与风险相称的代表性输入、状态或工作负载通过实际入口、核心处理、必要状态和真实依赖，产生用户可以直接判断的结果。只完成接线、框架、局部算法、测试或过程日志的技术骨架不是 demo；避开核心问题的玩具样例也不是 demo。

Demo 用于尽早判断路线是否值得扩大，不是把当前路线修到成功的义务。Demo 第一次失败后，先定位首个阻碍，并只做一个能区分局部缺陷与路线问题的最小修复或实验。这个实验没有推进核心结果或原因判断，或者同一路线为了通过 demo 不断增加前提、例外和跨组件补偿时，比较缩小、替换或重做路线，不再沿原路线补丁，也不扩展外围功能、参数组合、兼容层和成套测试。Demo 成立后，只有合同已有明确验收标准和连续推进授权时，当前代码阶段才直接扩展完整行为、边界、体验、规模和高风险验证；否则把用户可以判断的结果、差异和剩余投入交回上级校准。