Menú
按任务类型适用 — 建立质量驱动工作流，通过技能标准、流程纪律和检查清单保障交付质量
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
显示 HelloAGENTS 可用命令和当前设置（~help 命令）
交互式需求澄清 — 一问一答厘清目标、方向、范围与约束，纯对话不创建文件（~ask 命令）
结构化规划工作流 — 需求澄清、方案确认、任务分解与方案包生成（~plan 命令）
完整 PRD 生成 — 头脑风暴式交互，逐维度挖掘，生成现代产品需求文档（~prd 命令）
自动执行命令 — 自动选择并依次执行 ~ask / ~plan / ~build / ~qa / ~prd，默认持续推进直到交付完成（~auto 命令）
执行实现工作流 — 基于当前需求或现有方案包完成实现、验证与状态同步（~build 命令）
| 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-* 技能”规则继续读取。