code-development

代码开发

把用户要求落实为可以实际使用、并有相应证据的代码结果。工作按取得的反馈推进，研究、设计评审和专项测试由会改变当前结果的未知与风险决定。

本 Skill 同时供主 agent 和代码 subagent 使用。正文中需要向用户说明、提问或由用户决定的事项，由主 agent 与用户沟通。subagent 将具体事实、差异、影响和所需决定交回直接上级。产品目标、范围或成功标准需要重新判断时，subagent 先交回上级，由主 agent 组织产品判断。

从实际使用路径开始

从用户要获得的结果和可观察验收路径开始，确认修改范围、必须保持的行为和当前事实。沿实际入口、调用关系、状态与依赖，查到足以解释当前行为和决定下一项改动即可。

把当前要求转成可观察的目标行为和与用途相称的工程验收依据，覆盖会影响结果的接口、状态、可靠性及维护约束。普通技术细节由实现过程补足，产品用途和核心结果沿用已确认要求。

进入实现时沿用产品过程中与用户确认的使用情景、实例和边界。只有团队自行写出的规格或用户尚未看懂的方案时，不能据此认定重要体验已经确定；会改变当前切片目标或主要形态的歧义交回 product-development 核对。普通细节在已确认范围内自主完成，关键事实调查和帮助理解的原型可以先行。

需要用户判断的机制、方案或实现取舍难以直接理解时，使用 teach-and-explain，先说明它怎样改变实际操作、结果、成本或后续选择。核心路径首次可用、重要体验发生变化以及交付时，围绕原情景展示实际结果，区分技术行为已验证与个人体验仍待用户反馈。实现者和测试代理的认同不能代替用户的偏好判断。

核实用户实际启动或加载的版本及其配置，区分日常入口与隔离候选。任务只要求候选时按候选交付，否则把日常使用路径的更新与验证纳入结果，按已有授权执行。

依赖现有软件平台或组件时，从当前版本的源码或官方资料核实会决定实现的行为，需要确认加载结果时沿真实入口检查。能说明代码怎样进入现有系统、结果如何观察，而且剩余未知不会改变做法时，进入实现。

需要先决定重要接口或架构时，形成足以比较目标行为、主要结构、关键取舍与验收的简短设计，在大规模实现前检查方向。多个用户决定相互依赖、分别询问会使后续答案反复失效时，把会改变路线的关键问题及其影响集中交给用户；其他未知随着证据逐步解决。尚有会推翻方向的未知时，用定向调查或最小真实实验解决。局部改动在理解问题后直接修改。安全与边界检查由合同、现有代码或具体操作触发。

非平凡功能、跨模块或外部边界的变更、核心状态不变量、高风险变更，以及已有检查通过但用户结果仍失败的任务，在实现前读取 验收设计。用其中的当前任务规格和验收合同把结果、生产路径、反例和证据对应起来，并按风险决定是否展开完整生命周期。局部且结果唯一的修改直接采用必要部分，不为填写模板增加无用文档。

成品形态、核心价值或完成标准仍有多种合理解释，而且已有要求不足以决定时，向用户说明具体差异与影响。普通实现选择在已有边界内连续完成。

用户反馈或实现与使用证据使产品用途、完整体验、核心价值、范围或成功标准需要重新判断时，使用 product-development 处理受影响的产品决定，再据更新后的要求继续实现。已约定行为未实现且要求仍清楚的局部缺陷直接修复。

需求或证据变化后，先更新受影响的当前要求、已有说明、架构判断和验收依据，再继续相关工作。保留仍有效的内容，让接手者能从现有入口找到当前要求，已被取代的说明更新或标为历史。是否新增资料按交付部分的条件判断。

开发中的人机协作

需要用户共同判断功能或方案时，先调查并筛选会改变使用结果的选择，用代表性输入、操作情景、对照样例或可运行片段呈现差异。把相关技术机制连接到实际行为、代价和后续影响，帮助用户运用领域经验与使用感受形成判断。材料做到足以解决当前未知即可，普通实现、调试和工程检查由 agent 连续完成。

用户指出结果不合预期或感觉不对时，将原情景、预期结果与当前行为放在一起核对，借助具体操作和对照找出差异。由 agent 继续调查差异来自需求理解、方案假设还是实现行为，再按前述产品判断与局部修复规则处理。把反馈的适用条件和形成的决定带回受影响的规格、实现与验收。

面向用户展示当前可用结果、实际使用过程和会影响选择的机制与差异，提供方便查看或操作的入口。面向执行者保留接口、状态、实现位置、验证证据和剩余问题，使其可以准确接续。两类材料对应同一版本和决定，代码及工程记录按需可查。根据用户参与是否帮助澄清问题、辨别质量和减少返工，调整展示内容与交流时机。

进入代码前选择证据和路线

开始新的开发工作时段或恢复持续项目时，在首次修改生产代码前执行 验收设计 中的“开发前整体检查和证据选择”。先确认当前用户结果、日常入口到结果的完整运行路径、状态和决定的责任归属，以及当前待办在主路径中的位置。多轮决定已经散落、现有理解不能可靠指导下一步时，先使用 workflow-state-distiller 恢复当前状态；只看当前现象不足以判断原因、目标或成熟参照时，使用 xy-axis-thinking。状态和路径仍清楚时直接沿用，不重复生成说明。