From helloagents
Establishes a quality-driven workflow with skill standards, process discipline, and checklists to ensure delivery quality. Governs skill loading and turn-state for task execution.
How this skill is triggered — by the user, by Claude, or both
Slash command
/helloagents:helloagentsThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
【子代理短路】
【子代理短路】
若当前任务属于上级代理分派的局部任务、由宿主协作/委派机制创建,或当前输出会交回上级代理、控制器或其他代理继续汇总、决策、复述或等待后续动作,则立即跳过本 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 等文件,只在技能明确要求时再读禁止行为:
按以下路径查找,找到即停,不自行猜测或遍历其他路径。
路径定义:{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~idea~office~plan~build~prd~loop~init~test~qa~commit~clean~help兼容别名:
~do → 直接按 ~build 的 command skill 路径读取并执行~design → 直接按 ~plan 的 command skill 路径读取并执行~review → 直接按 ~qa 的 command skill 路径读取并执行只有当对应 command skill 明确要求再读取 hello-* 技能时,才按上方“hello-* 技能”规则继续读取。
npx claudepluginhub hellowind777/helloagents --plugin helloagentsDiscovers and invokes agent skills matching task phase (idea refinement, planning, implementation, testing, debugging, review, deployment). Use at session start or for skill selection.
Activates relevant agents before tasks for multi-agent analysis, time estimation, risk mapping, problem anticipation, and execution planning with contingencies. Triggers on task intelligence or pre-task briefing mentions.
Enforces workflows for skill discovery and invocation before tasks: check all skills first, read relevant ones, brainstorm before coding, create todos for checklists.