Evidence snapshot reviewed Aug 30, 2026GitHub checked Aug 21, 2026
Source-reviewedStandalone SkillCoding & Review

~build

Implements an approved task from current project context, runs focused validation, and hands completed work into QA.

At a glance

What it does

Implements an approved task from current project context, runs focused validation, and hands completed work into QA.

Capabilities
Coding & ReviewCodingTestingWorkflow Automation

Before you choose it

Restores the active task and plan, limits implementation to the confirmed scope, edits the project, runs targeted checks and repair loops, and updates only the directly affected task state.

Best for

HelloAGENTS users with a clear fix or an approved implementation plan.

Common tasks

  • Implement an approved feature
  • Fix a scoped defect
  • Continue an active plan through validation

Permissions and data

The workflow can modify project files and run project validation commands within the approved scope.

Permissions
  • Reads and edits project files
  • Runs focused project checks
Data handling
  • Updates task state and project files as described by the active plan

Limitations

  • Unclear or higher-risk work is redirected to planning
  • It must not claim completion without validation

What DSHub checked

  • The pinned source and supplied artifact evidence were captured.

What DSHub did not check

  • Installation and runtime behavior were not tested.

Pinned install

Primary action

This standalone skill does not have a DSH Plugin install action. Use its source documentation for the delivery method.

Visit the source project

Maintainer source

Skill instructions

View at commit 79c0b48
Maintainer-authored contentCaptured from skills/commands/build/SKILL.md on Aug 30, 2026. The text and repository-relative media are fixed to commit 79c0b482fd20 with content hash f20364aa9ee1; provider-hosted badges may update independently. SKILL.md commands are upstream documentation; use the type-correct primary action above and verify it against this pinned source.

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.mdverify.yaml 与方案包按当前上下文中已注入的项目知识/方案目录解析。

铁律

  • 默认先定位上下文与范围,再修改代码
  • 已有方案包时,优先按方案包执行,不重复发明方案
  • 没有运行验证,不能报告完成
  • 遇到高风险或阻塞情况立即停下确认

流程

1. 恢复与定位

  • 优先按当前已加载的 HelloAGENTS 规则恢复当前任务,并遵循“.helloagents/ 文件读取优先级”;若当前消息明确要继续上次任务、会话刚经历恢复 / 压缩,或当前运行在 Codex active goal 下,先读取 state_path,再用当前用户消息、活跃方案包 / PRD 与代码事实确认当前任务
  • 若存在最近的活跃方案包,读取对应的:
    • requirements.md
    • plan.md
    • tasks.md
    • contract.json
    • 实现时优先把 tasks.md 中每个任务的“完成标准”当作本次实现约束,不要只按任务标题猜测范围
    • contract.json 存在时,优先按其中的 qaModeqaFocus 理解后续质量闭环边界
  • 若当前运行在 Codex active goal 下,按 tasks.md 未完成项、contract.jsonstate_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 内把仍未闭合的方案包整体报告为已完成

Operate deliberately

Install and manage

Prerequisites and target Profile

Target No native DSH Profile target.

Delivery Skill Files — https://github.com/hellowind777/helloagents

Compatibility and access

Requires_host_review Not established by supplied evidence

Review compatibility evidence

Risk facts

Execution

Review instructions before use.

Evidence
Evidence and editorial reviewManifest, Bundle patch, distribution and freshness

Immutable evidence

Review status and source activity

Human approved

Approved for publication after reviewing the source-linked content and immutable release record. AI assisted with the draft; the publication decision was human.

Human reviewed Aug 30, 2026, 10:05 AM UTCGitHub facts last checked Aug 30, 2026, 9:53 AM UTC

No material source change has been recorded since this evidence baseline.

Next step

Compare ecosystem artifact types

Subscribe to material changes for ~build