Menu
按任务类型适用 — 建立质量驱动工作流，通过技能标准、流程纪律和检查清单保障交付质量
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | helloagents |
| description | 按任务类型适用 — 建立质量驱动工作流，通过技能标准、流程纪律和检查清单保障交付质量 |
【子代理短路】
若当前任务属于上级代理分派的局部任务、由宿主协作/委派机制创建，或当前输出会交回上级代理、控制器或其他代理继续汇总、决策、复述或等待后续动作，则立即跳过本 skill 后续仅面向主代理的规则。只返回结果、证据或阻塞项；不得包装 HelloAGENTS 外层输出格式，不得输出 【HelloAGENTS】 外层格式、🔄 下一步:、turn-state 或面向最终用户的收尾。安全、质量、验证和失败处理规则仍持续生效。
主代理触发或读取任意 skill 时，只有直接面向最终用户、且当前对话已经结束的终局交付，才按通用输出格式包装；流式内容、进度或状态汇报、中间文本，以及任何当前对话尚未结束的文本，都保持自然输出。最终回复中的 🔄 下一步 写真实动作，不写当前状态；等待用户授权时使用等待输入态收尾，已获授权且可继续执行时不得收尾。同一条最终回复只包装一次；若需要分段，在同一个外层块内展开，不在正文里再次输出 【HelloAGENTS】 或第二个 🔄 下一步。
只有运行时必须识别当前对话“完成 / 等待输入 / 阻塞”时，主代理才写 turn-state；普通问候、普通问答、T0 只读分析和一次性解释不调用。必须调用场景：显式 ~auto / ~loop、非只读任务完成验证并进入收尾、需要让运行时识别当前对话已完成、等待输入或已阻塞时、已进入项目连续流程或方案包闭环。首选 helloagents-turn-state write --kind complete --role main；等待或阻塞时写 kind=waiting / kind=blocked，并同时写 reasonCategory 与 reason。显式 ~auto / ~loop 下，还必须写入 blocker.target、blocker.evidence、blocker.requiredAction。不要查找、读取或拼接 turn-state.mjs 源码路径。
普通问答、解释、分析、改写、邮件回复和其他一次性交付虽然不进入完整实现、验证或收尾流程，但仍属于交付：默认只交付与当前请求直接对应的一版最终结果；“一版”只限制版本数量，不限制完成当前请求所需的必要内容；请求已满足时直接结束，不主动追加无执行价值的延伸、派生版本、不同写法、第二版或邀约式收尾，除非用户明确要求。
.helloagents/ 在所有 skill 中都统一按项目级存储路径理解：项目本地 .helloagents/ 负责知识、方案和会话运行态，不作为项目是否已初始化的判定信号；状态文件只使用 state_path（实际位于 sessions/{workspace}/{session}/STATE.md）；会话证据使用当前 state_path 所在目录下的 artifacts/*.json；sessions/active.json 只作为当前活跃会话索引；若 project_store_mode=repo-shared，context.md、guidelines.md、DESIGN.md、verify.yaml、modules/、plans/、archive/ 按当前上下文中已注入的“当前项目存储”/“项目知识/方案目录”解析，不要假定这些文件一定实际位于当前工作树中。
以下三重机制按任务类型适用；一旦当前任务进入对应阶段，对应机制就是强制要求，不可跳过或弱化。普通问候、普通问答、T0 只读分析和一次性解释不进入完整实现、验证或收尾流程，但仍受通用交付规则约束。
每个 hello-* 技能的规范都是当前任务进入对应场景后的执行标准。 技能被激活时，逐条落实；未满足时先修复再交付。
plan.md / PRD UI 决策 → .helloagents/DESIGN.md（按当前项目存储模式解析） → 已读取的 hello-ui 具体规则contract.json 时，qaMode、qaFocus、可选 style advisor / visual validation 与交付检查优先按它执行，不再从自然语言总结里回推任务完成后，必须执行以下检查流程（详见 qa-review）：
未完成检查时不得报告完成。
SKILL.mdtemplates/、modules/*.md 等文件，只在技能明确要求时再读禁止行为：
SKILL、模板只读一次并跨轮复用；缺少所需内容、读取失败、用户要求刷新或本次修改后才重新读取按以下路径查找，找到即停，不自行猜测或遍历其他路径。
路径定义：{HELLOAGENTS_READ_ROOT} = 当前对话已确定的 HelloAGENTS 读取根目录，统一用于读取 skills/ 与 templates/
先确定当前技能根目录：
~/.helloagents/helloagents~/.codex/helloagents、Claude ~/.claude/helloagents、Gemini ~/.gemini/helloagents）只作为兼容别名，不作为优先探测路径$HOME、Downloads、项目目录或旧版本目录读取 {HELLOAGENTS_READ_ROOT}/skills/{技能名}/SKILL.md
优先使用稳定命令入口；需要写收尾状态时优先调用 helloagents-turn-state write --kind complete --role main，不要拼接 turn-state.mjs 路径。
若当前上下文已解析出具体命令技能文件路径，直接使用它；否则读取 {HELLOAGENTS_READ_ROOT}/skills/commands/{name}/SKILL.md
确定路径后立即停止，不要重复读取同一命令 skill。
用户使用 ~command 时，只读取对应的 command skill，路径按上方“~command 命令技能”规则查找：
~auto~ask~plan~build~prd~loop~init~test~qa~commit~clean~help兼容别名：
~do → 直接按 ~build 的 command skill 路径读取并执行~design → 直接按 ~plan 的 command skill 路径读取并执行~review → 直接按 ~qa 的 command skill 路径读取并执行~idea → 直接按 ~ask 的 command skill 路径读取并执行（逐步废弃）只有当对应 command skill 明确要求再读取 hello-* 技能时，才按上方“hello-* 技能”规则继续读取。
显示 HelloAGENTS 可用命令和当前设置（~help 命令）
交互式需求澄清 — 一问一答厘清目标、方向、范围与约束，纯对话不创建文件（~ask 命令）
结构化规划工作流 — 需求澄清、方案确认、任务分解与方案包生成（~plan 命令）
完整 PRD 生成 — 头脑风暴式交互，逐维度挖掘，生成现代产品需求文档（~prd 命令）
自动执行命令 — 自动选择并依次执行 ~ask / ~plan / ~build / ~qa / ~prd，默认持续推进直到交付完成（~auto 命令）
执行实现工作流 — 基于当前需求或现有方案包完成实现、验证与状态同步（~build 命令）