SuperAPI AI 工具集

he-plan

智能体与模型

查看项目

更新于 10-16 10:25

技能介绍

用途

he-plan 是 Hard Eng 工作流中的规划技能,用于在实现变更之前制定计划、解决有实质影响的用户决策,并准备基于仓库事实的 UX 参考。它的目标产出是一份保存的 PLAN.md,内容包括:就绪的计划、适用的 UX 参考、基线证据、执行建议和授权边界;或者在存在阻塞性决策时明确列出这些决策。规划阶段可以产计划、进行研究并生成隔离预览;正式的生产实现需要等待就绪状态与授权。

主要能力

  • 按规划需求选择路线:明确的大型、不清晰工作走 wayfinding 参考;小型清晰变更使用精简 PLAN.md;完整功能或跨多会话的实质性工作使用 PLAN.md 模板。
  • 当变更涉及可见变化时,引入 UX 参考(references/ux.md)。
  • 生成并复用 PLAN.md:每个工作单元一份计划,放在根目录或 features/<slug>/PLAN.md(文件名不区分大小写),复用同一份计划。
  • 规范计划内容:填写简短字段和行为到证明的复选框,而非叙述性段落,链接详细证据而非复制。每一节都要填写,不适用处必须基于仓库事实给出理由;工具不可用、检查失败和缺失证明属于阻塞项,不能写不适用。
  • 提问策略:先检查仓库事实,只询问依赖用户、且会改变结果、UX、范围或重大风险的选择。先解决前置选择,独立问题批量提问并附推荐与后果,不替用户作答,也不把沉默当作同意;请求清晰时不进行仪式性访谈。
  • 证明与验收:将每个实质性请求行为和保留约束对应到预期的检查和可观察的预期结果,放入 Acceptance 和步骤;缺失证据或工具失败视为阻塞项。
  • 交付与顺序:保持构建验收在本地完成,把授权目的地和待定的远程证明保留在 Verification 中交给 HE Ship;本地完成先于发布。每个实质性切片交付可观察行为,并选择早期薄片覆盖重大不确定性。
  • 就绪与授权:Ready 条件包括结果与边界明确、阻塞性选择已解决、UX 方向已确定、基线通过、计划验收检查和可执行的第一步齐备等。授权来自用户对话指示,覆盖结果与边界。

使用方式

根据用户意图和实际范围选择路线,而非仅凭关键词。已有就绪计划时在其授权范围内继续;出现实质性变更时只重开受影响的那一个决策。先检查仓库事实,再提出必要问题。计划检查在重大选择解决后、授权实现前通过一次 Ready 检查。

适用场景

  • 小型清晰变更的精简规划。
  • 完整功能或跨多会话的实质性工作。
  • 大型、不清晰工作前的探索与 wayfinding。
  • 涉及可见界面变更时需要 UX 参考的规划。

限制

规划本身只产出计划、研究和隔离预览,生产实现需要就绪与授权。工具不可用、检查失败或缺失证明会阻断就绪状态。关于具体模型/工具能力,不得臆造可用性,也不得在规划阶段强制多智能体或进行派发。其他如收费、价格、平台等具体信息暂未提供。