build

Trigger: ~build [description] `~build` 是执行实现命令。它负责读取现有需求、方案包与项目上下文，完成实现、局部验证、修复循环，并把结果交给后续质量闭环与收尾。 执行 `~build` 时，通用阶段边界按当前已加载的 HelloAGENTS 规则执行；本 skill 负责补充实现前定位、实现约束，以及进入 `~qa` / 收尾前的实现边界。 `.helloagents/` 在本 skill 中统一按项目级存储路径理解：状态文件只使用 `state_path`；会话证据使用当前 `state_path` 所在目录下的 `artifacts/*.json`；若 `project_store_mode=repo-shared`，知识库、`DESIGN.md`、`verify.yaml` 与方案包按当前上下文中已注入的项目知识/方案目录解析。 ## 铁律 - 默认先定位上下文与范围，再修改代码 - 已有方案包时，优先按方案包执行，不重复发明方案 - 没有运行验证，不能报告完成 - 遇到高风险或阻塞情况立即停下确认 ## 流程 ### 1. 恢复与定位 - 优先按当前已加载的 HelloAGENTS 规则恢复当前任务，并遵循“.helloagents/ 文件读取优先级”；若当前消息明确要继续上次任务、会话刚经历恢复 / 压缩，或当前运行在 Codex active goal 下，先读取 `state_path`，再用当前用户消息、活跃方案包 / PRD 与代码事实确认当前任务 - 若存在最近的活跃方案包，读取对应的： - `requirements.md` - `plan.md` - `tasks.md` - `contract.json` - 实现时优先把 `tasks.md` 中每个任务的“完成标准”当作本次实现约束，不要只按任务标题猜测范围 - `contract.json` 存在时，优先按其中的 `qaMode`、`qaFocus` 理解后续质量闭环边界 - 若当前运行在 Codex active goal 下，按 `tasks.md` 未完成项、`contract.json` 与 `state_path` 恢复实现位置；不要自动创建新 goal，也不要把 goal 目标原文替代方案包 - 若当前上下文中已注入“当前工作流约束”或“当前推荐下一命令”，先服从它；只有推荐仍为 `~build`，或用户明确提出新增实现范围时，才继续 `~build` - 其余项目知识库与相关代码文件，按 HelloAGENTS 项目上下文要求读取 - 若任务涉及 UI，按以下优先级读取并遵循：当前活跃 `plan.md` / PRD 中的 UI 决策 > 逻辑 `.helloagents/DESIGN.md`（实际路径按当前项目存储模式解析） > 已读取的 `hello-ui` 规则；同时所有 UI 任务都必须满足 UI 质量基线 - 若当前项目已有本地项目存储，且当前任务属于整页新建、设计系统改造、或跨多个组件的视觉重做，但逻辑 `.helloagents/DESIGN.md` 不存在，先按模板创建最小设计契约，再继续大规模实现 如果 `.helloagents/` 不存在： - 按当前已加载的 HelloAGENTS 规则创建 `.helloagents/` 与最小流程状态 - 仅补足执行当前任务所需的最小状态，不自动展开完整知识库 ### 2. 需求与范围确认 先判断任务是否有方案包支撑： - 有活跃方案包 → 按方案包执行，直接确认范围 - 无方案包 + 任务可判定为 T1（如"加个 loading 动画"、"修个 typo"）→ 直接执行 - 无方案包 + 任务 T2+（多文件功能、架构变更、新模块）→ 不直接写代码，自动重定向到 `~plan`，先厘清需求再执行。方向完全不明时由 ~plan 内部走交互澄清确认 - 若仍存在真实歧义，仅询问阻塞执行的关键决策 ### 3. 执行实现 - 根据任务拆解逐步修改 - 按当前实现需要读取对应的 hello-* 技能，并遵循其规范 - 编码任务遵循： - 先补测试或最小验证手段，再写实现 - 每次编辑后主动跑确定性检查 - 可并行任务通过子代理执行，但不同子代理不得改同一文件 ### 4. 局部验证与修复循环 - 按当前任务与 `tasks.md` 中的“验证方式”运行 lint / typecheck / test / build 等局部验证 - 若失败，修复后重跑 - 若当前实现已接近交付，主动对照 `qaFocus` 自检本次改动是否覆盖关键风险 ### 5. 交付前处理 - 有方案包时，只同步本次实现直接影响的任务状态；未完成项保持打开 - 当前实现已闭合、且需要进入交付或收尾时，转入 `~qa` - 若 Codex active goal 仍有未完成 AFK 任务，继续下一项可执行任务；若目标已满足，先转入 `~qa` 与 HelloAGENTS 收尾，再标记 goal complete - 状态文件、知识库、`CHANGELOG.md`、modules 文档与归档边界，按当前已加载的 HelloAGENTS 规则进入质量闭环 / 收尾与归档 - 不在 `~build` 内把仍未闭合的方案包整体报告为已完成