SuperAPI AI 工具集

he-build

编程与开发

查看项目

更新于 10-16 11:26

技能介绍

he-build(Hard Eng Build)是针对 Flutter 应用的构建阶段技能,属于 building-flutter-apps 工作流的一部分。

一、用途 它的输入是现有且已就绪、已授权的 HE Plan 计划。使用前需要检查该计划的就绪证据,包括通过的基线、适用的用户体验(UX)与阻塞项,而不是只依据 Status 字段。若仅有基线修复失败,可走该计划授权的草稿修复路径;功能工作仍被阻塞,直到修复交付完成。其他缺失、待定或矛盾的就绪状态,需交回对应负责人处理后再进行生产编辑。发生实质性范围变更时,也需交回同一负责人,并保留已接受的决策与已完成的工作。参与方式与项目上下文参见 HE 工作流。

二、输出 输出是本地已实施并通过验证的行为、完整的计划,以及明确的“可交付/可发版”交接。构建本身不授予提交、推送、发布、合并或部署的权限,交付是单独阶段。

三、实施与验证流程 流程为:下一个完整行为 → 实施 + 聚焦检查 → 审查实际差异与受影响的证明 → 若未通过则诊断并定位负责人后回到实施,循环直到通过 → 检查是否还有剩余构建工作,有则继续下一行为,无则进入集成证明与 Complete 门禁 → 门禁失败则回到诊断修复,通过则进入 Ready for ship。

行为指必备的连通调用方、持久化、API 与接口工作;骨架或文件清单不是可接受的成果。变更应保持在既有负责人范围内;仅针对变更边界应用相关的技术栈、设计与安全指导。

证明由测试质量加实际差异审查构成;必需的运行时旅程、可视证据及适用的无障碍状态指向 E2E。PR 证据选择指向 HE Ship。回归、缺陷重开和评审发现复用这些负责人;不设重复检查器或强制性的测试/代理数量。

进度以同一计划加剩余工作表示。保留实际起始基线结果与证据,后续构建结果记录在 Verification 中。在无阻塞的功能构建期间保持 Status 为 Ready、Verification 为 Pending;基线修复遵循上文 HE Plan 的草稿路径。出现实质性决策或不可用前置条件时,转为 Draft 并记录确切阻塞项与恢复条件,保留已完成步骤并继续独立的授权工作。绝不以通过或 N/A 替代缺失的证明。

四、并行工作与集成 仅派遣独立的完整行为,需有具名负责人、约定的接口并满足依赖,且要在任务的委派授权范围内。小规模工作留给单一构建者。检查实际源文件与共享影响:生成文件、锁文件、测试夹具、端口与数据库即使编辑路径不相交也可能产生争用。

需要时使用隔离;串行化冲突工作与共享 Git 操作。在共享检出中,一个负责人控制每个写入面;工作者避免安装、构建或测试以防改动其他工作者状态。工作树不会隔离外部资源。

工作者结果包括正常交接中的变更路径、实际命令与结果及阻塞项。协调者检查实际差异与共享契约,按依赖顺序集成,并在合并结果上运行必需检查。保留无主变更。工作者通过或干净合并并不能证明集成成功。

五、构建完成到可交付 将最终差异与每一项已接受需求及后续修正(包括计划中明确的 E2E 处置)对照。必需的本地旅程须有 Passed 证据;只有依赖部署的证明可留作 Delivery,需有 Deploy 目标及配置的验证器。已确认的评审发现已解决,且无构建阻塞项。评审声明须对照实际测试/运行时证据;仅计划勾选框只是声明。

在计划中记录实际的聚焦测试/运行时证据,只勾选已验证的验收项,设置 Status Complete 与 Verification Passed,然后在最终集成代码上运行既有 Complete 检查。Ready 检查负责规划/基线就绪,不要将其重复为额外的构建门禁。失败则按该门禁的草稿/阻塞恢复流程处理并继续循环;绝不宣布 Ready for ship。通过后若发生代码/配置更改,需要重新提供受影响证明并再次运行最终门禁。

门禁通过后,告知用户“Ready for ship——本地实施与验证完成,未执行交付”。交接内容包括已实施成果、实际检查/运行时证据及待交付要求。Complete 计划已记录该阶段;不要重写它,也不要仅为记录此通知而重复应用检查。授权交付继续通过 HE Ship 进行;仅构建不增加交付权限。不设 BUILD.md 或第二状态记录。

六、限制 涉及提交、推送、发布、合并或部署的权限不在本技能范围;缺失信息暂未提供。