Stats
Actions
Tags
From helloagents
Structured planning workflow for requirement clarification, solution design, task breakdown, and plan package generation. Use before implementation to ensure clear scope and actionable plans.
How this skill is triggered — by the user, by Claude, or both
Slash command
/helloagents:planThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Trigger: ~plan [description]
Trigger: ~plan [description]
~plan 是实现前的主规划命令。它负责需求澄清、方案设计、任务拆解与方案写入；直接显式执行 ~plan 时，默认停在“形成可执行方案”，只有用户明确授权继续时才继续执行。
执行 ~plan 时，通用阶段边界按当前已加载的 HelloAGENTS 规则执行；本 skill 负责补充 ~plan 的需求澄清、方案确认、方案包写入与继续执行要求。
.helloagents/ 在本 skill 中统一按项目级存储路径理解：状态文件只使用 state_path；会话证据使用当前 state_path 所在目录下的 artifacts/*.json；若 project_store_mode=repo-shared，知识库、DESIGN.md 与 plans/ / archive/ 按当前上下文中已注入的项目知识/方案目录解析。
~auto，则“开始执行”视为已包含在 ~auto 授权内；方案包写入后默认继续执行，只有命中阻塞判定时才停下。~design 是 ~plan 的兼容别名，只有在 ~auto 内触发其语义时才默认继续进入 ~build.helloagents/DESIGN.md；.helloagents/DESIGN.md（按当前项目存储模式解析）优先于已读取的 hello-ui 规则；同时所有 UI 任务都必须满足 UI 质量基线已有项目：
state_path，再用当前用户消息、显式命令、活跃方案包 / PRD 与代码事实确认当前任务.helloagents/context.md、.helloagents/guidelines.md（按当前项目存储模式解析）；涉及 UI 时，如存在 .helloagents/DESIGN.md（按当前项目存储模式解析），一并读取现有设计契约全新项目（无 .helloagents/ 目录）：
目标：通过自然对话明确目的、约束、成功标准与验收边界。
根据项目类型选择模式：
假设模式（已有代码库，优先使用）：
.helloagents/context.md 的领域语言冲突时，立即澄清并统一术语交互模式（全新项目或信息不足）：
涉及视觉/交互/体验的问题时：
基于已确认需求，给出 2-3 个可行方案：
涉及 UI 的方案：
hello-ui SKILL.mdplan.md，后者同步到 .helloagents/DESIGN.md（按当前项目存储模式解析）用户确认方向后，一次性输出完整可执行方案：
qaMode、qaFocus、进入收尾前必须补齐的质量证据）DESIGN.md 更新点.helloagents/context.md 的“领域语言”区块（按当前项目存储模式解析）将确认的方案写入本地项目：
.helloagents/ 与最小流程状态.helloagents/plans/YYYYMMDDHHMM_{feature}/（按当前项目存储模式解析；repo-shared 时写入当前项目方案目录）{HELLOAGENTS_READ_ROOT}/templates/plans/ 为源模板，在上述方案包目标目录内写入：
requirements.mdplan.mdtasks.mdcontract.jsoncontract.json 时，至少落成以下字段：qaMode、qaFocus；涉及 UI 时再写 ui.required、ui.designContract 与 ui.sourcePriorityui.styleAdvisor.required、ui.styleAdvisor.reason 与 ui.styleAdvisor.focus；它复用当前会话 artifacts/advisor.json，不是默认常驻步骤ui.visualValidation.required、ui.visualValidation.reason、ui.visualValidation.screens 与 ui.visualValidation.states；不要把视觉验收扩成所有 UI 任务的固定步骤T3、非 UI 的高风险审查或确需额外跨模型建议时，才写 advisor.required、advisor.reason、advisor.focus 与 advisor.preferredSources；不要把 advisor 变成默认常驻流程scripts/plan-contract.mjs write 写 contract.json，不要让后续检查脚本再从 plan.md 的自然语言说明里猜验证主路径tasks.md 中保留 “Codex /goal 执行入口”，内容必须引用当前方案包路径、AFK/HITL 边界，并明确 /goal -> ~auto -> ~qa 这条链路；不要把普通 PRD 原文当作 /goal 目标.helloagents/DESIGN.md（按当前项目存储模式解析）；若原文件不存在，先按模板建立最小设计契约，再写入已确认的稳定设计决策state_path，其中“主线目标”写本次规划要完成的目标，不保留其他任务的内容知识库完整创建与归档按当前已加载的 HelloAGENTS 规则继续处理。
展示方案摘要后，仅在是否进入执行仍构成阻塞决策时才询问用户：
~buildstate_path；“主线目标”写当前已确认方案要解决的问题，下一步写为“方案已确认；执行需用户明确启动”如果用户已明确表示继续执行，则视为授权成立，可直接继续执行。
如果当前任务来自 ~auto，且方案包已足够支撑实现、也未命中阻塞判定，则默认直接进入 ~build，不再追加一次“是否开始执行”的询问。
如果当前任务是显式 ~plan 或 ~design，且尚未获得执行授权，最终回复按通用输出格式使用等待输入态：正文说明方案包与验证结果，🔄 下一步 写清待确认动作。
方案包中的 tasks.md 必须满足：
AFK 或 HITL：AFK 表示代理可独立完成，HITL 表示需要用户决策、外部凭据、人工视觉确认或手动验收tasks.md 执行，默认主执行命令是 ~auto，最终必须进入 ~qa，而不是直接消费未拆分需求文档方案包中的 contract.json 必须满足：
qaMode 只能是 standard 或 deepqaFocus 必填ui.styleAdvisor，必须写清触发原因与 focusui.visualValidation，必须写清触发原因，以及至少一组关键 screens 或 statesnpx claudepluginhub hellowind777/helloagents --plugin helloagentsBrainstorms intent, requirements, and design before writing a structured plan. Use before any creative work or multi-step task to avoid premature coding.
Creates structured implementation plans for multi-step tasks from specs or requirements. Generates plan.json and task markdown files with explicit code and testing steps.
Creates executable implementation plans from design folders, decomposing into granular tasks via Superpower Loop phases: structure, decomposition, validation, reflection, git commit.