Files
shanxia2.0/.agents/skills/personal-dev/references/implementation.md
T

3.9 KiB

实施流程

范围与隔离

接入或执行中遇到关键未知项,按关键疑问先澄清暂停依赖该决定的部分;以下工单、修改端与界面门槛仍适用。

配置应用认证或使用工单、仓库、服务器、设计平台账号时,先按凭据用途与来源区分运行配置和 Agent 操作凭据,再查对应来源、处理缺失项。

正式需求或 Bug 按以下顺序接入工单:

  • 用户给出编号或链接:按工单全文、评论与图片读取工程配置仓库的完整上下文,再定位和实施;不能只凭聊天摘要猜测工单内容。
  • 用户未给编号:先创建包含诉求、范围和验收条件的工单,取得编号后实施。若是在继续当前已有明确关联的任务,复用原工单,不重复创建。
  • 在工程已有授权内直接创建与回写,不要求用户代建。连接或权限不可用时说明实际阻碍,不虚构编号或同步成功;继续可独立完成的只读定位,恢复连接后补齐工单再实施。

新建工单、续接任务及交付前,同样按工单上下文核对全部评论与图片的补充和变化。

来自工单队列的任务复用已领取编号与检查点,按本流程完成单工单实施;领取、阻塞、停止和续接遵循队列规则。队列控制不会替代下述范围确认、原型或测试责任。

实施前确认修改端:先读取当前任务对话及工单中的已确认范围;已有明确结论时沿用。用户未明确修改端且既有记录也未确认时,必须询问“这次修改 Web、小程序、移动 OA、其他端中的哪些端,还是所有相关端?”,选项按工程实际应用列出;截图或当前打开的目录仅作定位线索,不能代替范围确认。

等待答复时可只读定位、创建或更新工单并标记“修改端待确认”,取得用户选择或按统一三分钟策略采用推荐前不修改业务代码,也不默认只改当前端或全部端。取得决定后将具体应用清单及验收范围写回工单;“所有端”落实到实际应用清单。若共享后端/API 的拟议变更会影响确认范围之外的端,先说明连带影响并确认范围扩展,再实施。

按工程集成分支准备任务分支及 worktree;继续同一任务先核对已有隔离目录并复用。优先宿主原生工具,不支持目标仓库时使用工程约定 fallback。原目录的未提交改动保留原地。本机运行目录、端口、配置、数据隔离及切回集成版本的方式按本机环境验证与集成提前安排;不默认访问真实业务库。

读取涉及应用的规则和环境条件,实施前按测试责任确定由 Agent 还是用户执行测试。局部 Bug 定位原因并提供回归覆盖点;用户测试模式不由 Agent 执行复现或回归测试。功能实现以已确认规格为输入。

界面

界面实现及布局样式修改读取界面一致性、原型与验收,先确定同端同类参考和复用依据,再按适用范围完成原型确认与视觉验收;用户免除原型时仍执行其中的一致性要求。

工程卫生与沉淀

安装、更新依赖或下载构建工具前读取依赖下载与镜像,按当前环境选择来源并核对安装结果。

临时文件写入工程配置的本地目录;需要长期保留的有效经验整理入知识目录,并引用复现、原因、修复及验证证据。规范性结论更新对应权威规则,不仅藏在复盘里。

清理前核对代码、测试、脚本、部署和文档引用;名称、日期或一次检索无结果不是删除依据。凭据按用途与来源分开管理,并区分环境,版本管理只记录空值样例和来源。现有目录按职责映射,不随意新建平行体系。