SuperAPI AI 工具集

he-plan

编程与开发

查看项目

更新于 10-16 09:26

技能介绍

用途

he-plan 是 Hard Eng 工作流中的规划环节,目标是在实现变更之前先完成规划。其输出为保存的 PLAN.md,内容包括:就绪的计划、适用时的 UX 参考、基线证据、执行建议、授权边界,或明确列出的阻塞性决策。规划阶段可以产出计划、调研与隔离预览;生产实现需等待就绪与授权。

主要能力

  • 路线选择:根据用户意图与实际范围(而非单一关键词)选择路线。已有就绪计划则在其授权范围内继续;发生实质性变更时只重新打开受影响的决策。
  • 路线分支:明确需要 Wayfinder 或大型不清晰工作时走 references/wayfinding.md;小型清晰变更使用紧凑 PLAN.md;功能或实质性、多会话工作使用 templates/PLAN.md。方向确定且请求实现后进入完整计划模板。
  • 可见变更判断:若涉及可见变更,进入 references/ux.md 准备 UX 参考;否则直接进入就绪与授权环节。
  • 计划与提问:先检查仓库事实,只询问会改变结果、UX、范围或重大风险的用户相关选择。先解决前置选择,独立问题批量提出并附建议与后果。不得替用户作答,也不得将沉默视为批准。请求清晰时不做仪式性访谈。
  • 证据与证明:将每个实质性请求行为与保留约束对应到预期检查与可观察结果,写入验收与步骤;明确标注排除项或阻塞项。E2E 处置与 ux_reference 分开填写。
  • 交付与流程缺口:构建验收保持在本地;在 Verification 中保留授权目标与待完成的远程证明,供 HE Ship 使用。UI 实现前保留实际基线用于后续 PR 对比。对实质性状态、权限、恢复或跨系统行为,在 Ready 前检查现有入口、相关分支与成功/失败/恢复结果。
  • 不确定性与排序:对重大未验证技术假设,记录当前证据、最便宜的判别性检查及假设为假时的影响。每个实质性切片应交付可观察行为;存在重大不确定性时选择早期薄切片。
  • 执行建议:给出适合本计划的最小安排,说明职责、依赖与实际可用的模型/工具能力,不虚构模型可用性,不强制四个智能体,也不在规划阶段派发。

使用方式

按 Hard Eng 工作流使用。复用当前仓库证据与已定决策;仅在需要时加载 Research 或 Codebase Design。计划文件为 PLAN.md,每个工作一份,位于根目录或 features/<slug>/PLAN.md(文件名不区分大小写),可复用。填写简要字段与行为→证明复选框,而非叙述段落;链接详细证据而非复制。每个部分都要填写;N/A 必须附仓库事实理由。工具不可用、检查失败与缺失证明属于阻塞项,不得标为 N/A。

设置/采用/更新时,遵循集成设置以适配预期服务、托管、现有选择与真实主机就绪情况;仅凭全新导入无法识别未来集成。新建 Flutter 应用按 Building Flutter Apps 使用 Riverpod。

就绪与授权

Ready 条件:结果与边界已理解;重大阻塞性选择已解决;适用时已展示 ux_reference 且方向已定;基线通过且前置修复已交付;已规划验收检查、可执行第一步与执行建议。通过并获授权后,明确告知用户:Ready for build — plan and baseline are verified; implementation is starting。证明待定或受阻时不得使用该交接。

授权来自用户在上述参与规则下的对话指令;计划记录其范围,而非自行签发的许可。可复用有效的提案批准或自主授权。否则展示完成的计划并询问一次是否继续;仅规划请求以保存的 PLAN.md 结束,而非仅聊天中的计划。批准覆盖结果与边界;文件/步骤/测试/内部方法变更更新同一计划并继续;结果、重大范围/风险或未授权的重大行动变更只解决该边界。

适用场景

适用于在实现前需要规划变更的软件开发工作,包括小型清晰变更、功能开发、多会话工作、方向不明的大型工作,以及需要 UX 参考与基线证据的场景。

限制

规划阶段不进行生产实现,需等待就绪与授权。不得替用户回答、不得将沉默视为批准、不得虚构模型可用性或强制智能体数量。缺失预览时计划保持 Draft。未提供具体收费、价格、平台与效果信息。