SuperAPI AI 工具集

he-build

编程与开发

查看项目

更新于 10-16 10:18

技能介绍

he-build 是 Hard Eng 工作流中的构建阶段技能,负责在已有授权计划的基础上完成实现与验证,并最终给出可交付(Ready for ship)的交接。它的来源标识为 sgaabdu4/appwrite-backend,页面地址为 https://www.skills.sh/sgaabdu4/appwrite-backend/he-build。

用途与输入 he-build 用于实现并验证一个已经“Ready 且已授权”的计划。该计划来自 HE Plan。它要求检查计划的就绪证据(通过的基线、适用的 UX、阻塞项),而不是只看状态字段。如果基线本身失败,只能沿 HE Plan 授权的 Draft 修复路径处理,功能工作在修复交付前仍被阻塞;其他缺失、待定或相互矛盾的就绪情况都要先回到对应属主处,再动生产代码。若发生实质性范围变更,同样由该属主处理,并保留已接受的决策与已完成工作。参与方式与项目上下文参考 HE 工作流。

主要能力与工作循环 输出是“本地已实现并已验证的行为”、Complete 计划,以及明确的 Ready for ship 交接。构建本身不增加任何 commit、push、publish、merge 或 deploy 的权限,交付是单独阶段。 判断流程为:

  1. 取下一个完整行为;
  2. 实现并做聚焦检查;
  3. 审查实际 diff 与受影响的证明;
  4. 判断是否通过:不通过则诊断并交由属主修复,再回到实现;
  5. 通过后判断是否还有剩余构建工作:有则回到下一行为;
  6. 没有则执行集成证明与 Complete 关卡;失败则回到诊断修复;
  7. 通过则进入 Ready for ship。 其中实现、审查、诊断排查、关卡等环节分别指向 testing.md、code-review/SKILL.md、troubleshooting.md、gates.md#plan-checks 等参考文件。 所谓“行为”是指必需的连通调用方、持久化、API 与接口工作;只有骨架或文件清单不算可接受结果。改动应保持在既有属主处;只对变动的边界应用相关的技术栈、设计、安全指引。

证明与进度记录 证明由测试质量与实际 diff 审阅构成;必需的运行时旅程、视觉证据与适用的可访问性状态归 E2E 处理;PR 证据选择归 HE Ship。回归、缺陷重开与审查发现复用这些属主,不设重复检查器,也不强制测试或代理数量。 进度沿用同一计划与剩余工作,保留实际起始基线的结果与证据,后续构建结果记入 Verification。在无阻塞的功能构建期间保持 Status Ready 与 Verification Pending;基线修复按上文 HE Plan 的 Draft 路径处理。出现实质性决策或不可用前置条件时,转为 Draft 并记录精确的阻塞点与恢复条件,保留已完成步骤,并继续独立的已授权工作。绝不用“通过”或 N/A 替代缺失的证明。

并行工作与集成 只派发独立的完整行为,并具备具名属主、约定接口与已满足的依赖,且须在任务的委派授权范围内。小任务由单个构建者完成。要检查实际源码与共享影响:生成文件、lockfile、fixture、端口与数据库即使编辑路径不相交也可能争用。必要时使用隔离;对冲突工作与共享 Git 操作串行化。在共享检出中,每个写入面由单一属主控制;工作者避免安装、构建或测试去改动其他工作者的状态。worktree 不隔离外部资源。 工作者结果以常规交接形式给出:变更路径、实际命令与结果、阻塞点。协调者检查实际 diff 与共享契约,按依赖顺序集成,并在合并结果上运行必需检查。保留无属主变更。工作者自测通过或干净合并都不能证明集成成功。

构建完成到可交付 将最终 diff 与每一项已接受需求及后续修正对齐,包括计划中明确的 E2E 处置。必需的本地旅程必须有 Passed 证据;只有依赖部署的证明可以在 Deploy 目标及其配置校验器下保留为 Delivery。已确认的审查发现须解决,且不剩构建阻塞项。要对照实际测试与运行时证据审查声明,计划里的勾选框本身只是声明。 把实际的聚焦测试与运行时证据记录到计划中,只勾选已验证的验收项,设置 Status Complete 与 Verification Passed,然后在最终集成代码上运行既有的 Complete 检查。就绪检查归规划与基线就绪性所有,不要把它作为额外的构建关卡重复执行。失败则按该关卡的 Draft/阻塞恢复流程处理并回到循环,绝不宣布 Ready for ship。一次通过之后若再有代码或配置改动,需要重新取得受影响的证明并再次运行最终关卡。 关卡通过后,告诉用户 Ready for ship——本地实现与验证已完成,尚未执行交付。交接内容包括已实现的结果、实际检查与运行时证据、待完成的交付要求。Complete 计划已经记录该阶段,不要重写它,也不要仅为记录这个宣告而重复应用检查。已授权的交付继续走 HE Ship;仅构建阶段不增加交付权限。不使用 BUILD.md 或第二份状态记录。

适用场景与限制 适用于已有 HE Plan 授权计划的实现与本地验证阶段,尤其是需要按行为拆分、并行集成、以实际 diff 与运行时证据为准的工程场景。限制包括:不授予交付权限;无法在缺证据时给出通过;就绪性由既有就绪检查负责;计划若缺失、待定或矛盾必须先回到属主;文档未提供计费、价格、平台支持范围等具体信息,这些内容暂未提供。