From helloagents
Enforces quality-driven workflows for skills using task-type standards, process discipline across ROUTE/SPEC/PLAN/BUILD/VERIFY/CONSOLIDATE stages, and checklists with lint/test/build verification before completion.
npx claudepluginhub hellowind777/helloagents --plugin helloagentsThis skill uses the workspace's default tool permissions.
主代理触发或读取任意 skill 时,只有本轮最终收尾消息才按通用输出格式包装;流式内容、进度或状态汇报、中间文本,以及任何仍将继续执行的文本,都保持自然输出。最终收尾中的 `🔄 下一步` 写真实动作,不写当前状态;等待用户授权时使用等待输入态收尾,已获授权且可继续执行时不得收尾。
Creates and validates Claude Code skills/subagents in fast/full modes, decides skills vs subagents, migrates docs to skills, estimates tokens, runs security scans.
Guides designing Claude Code skills with multi-step phases, decision trees, subagent delegation, progressive disclosure. For sequential pipelines, routing, safety gates, task tracking, or refactoring workflows.
Enforces workflows for skill discovery and invocation before tasks: check all skills first, read relevant ones, brainstorm before coding, create todos for checklists.
Share bugs, ideas, or general feedback.
主代理触发或读取任意 skill 时,只有本轮最终收尾消息才按通用输出格式包装;流式内容、进度或状态汇报、中间文本,以及任何仍将继续执行的文本,都保持自然输出。最终收尾中的 🔄 下一步 写真实动作,不写当前状态;等待用户授权时使用等待输入态收尾,已获授权且可继续执行时不得收尾。
子代理只豁免路由与收尾要求,直接执行任务;安全、质量、验证和失败处理规则仍持续生效,且不得包装 HelloAGENTS 外层输出格式。
只有运行时必须识别本轮“完成 / 等待输入 / 阻塞”时,主代理才写 turn-state;普通问候、普通问答、T0 只读分析和一次性解释不调用。必须调用场景:显式 ~auto / ~loop、非只读任务完成验证并进入收尾、需要 delivery gate / Ralph Loop / closeout evidence、需要等待或阻塞且运行时必须识别状态、已进入项目连续流程或方案包闭环。首选 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 源码路径。子代理不得写 turn-state。
.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 具体 UI 审美与实现规则,并与 UI 质量基线共同生效contract.json 时,验证分流、reviewer / tester 关注边界、可选 style advisor / visual validation 与交付检查优先按它执行,不再从自然语言总结里回推任务完成后,必须执行以下检查流程(详见 hello-verify):
未完成检查时不得报告完成。
技能分三层加载,严格按需,不提前读取:
Layer 1 — 元数据(启动时已知,不需要读取文件): 仅凭下方列表中的名称和描述判断技能是否可能相关。
Layer 2 — 完整技能(进入对应阶段时读取 SKILL.md): 当任务进入某个阶段且该阶段需要某技能的规范时,才读取该技能的 SKILL.md。
Layer 3 — 资源文件(技能内引用时读取): 技能 SKILL.md 中引用的 templates/、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~plan~build~prd~loop~wiki~init~test~verify~commit~clean~help兼容别名:
~do → 直接按 ~build 的 command skill 路径读取并执行~design → 直接按 ~plan 的 command skill 路径读取并执行~review → 直接按 ~verify 的 command skill 路径读取并执行只有当对应 command skill 明确要求再读取 hello-* 技能时,才按上方“hello-* 技能”规则继续读取。