---
name: ~build
description: 执行实现工作流 — 基于当前需求或现有方案包完成实现、验证与状态同步（~build 命令）
policy:
  allow_implicit_invocation: false
---
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` 内把仍未闭合的方案包整体报告为已完成