SuperAPI AI 工具集

plannotator-setup-goal

通用与其它

查看项目

更新于 10-15 19:53

技能介绍

用途:为 Codex 的 /goal 长期运行任务创建持久化目标包,放在当前项目的 goals/<slug>/ 目录,使任务具备明确使命、护栏、完成证明和外部记忆。

主要能力:先确认工作目录为项目根目录或用户指定目录,收集命名目标、预期结果、约束、项目文档与完成证明所需上下文;目标含糊、风险高、范围过大、缺少终点或验证方式时须提问,不得猜测关键需求。随后用脚本搭建目录:python3 <skill_dir>/scripts/scaffold_goal.py --root . --slug <slug> --title "<goal title>" --objective "<one sentence outcome>"。按顺序起草并完善 brief.md、plan.md、verification.md、blockers.md、goal-prompt.md。

使用方式:每份关键文档都要用 plannotator annotate goals/<slug>/<document.md> --gate 提交用户评审;若被拒绝或收到批注,视为反馈,修改后重新执行同一命令,直到通过。全部通过后给出最终路径和 goal-prompt.md 中的 /goal 提示词。progress.jsonl 为追加式证据,不设评审门。

文档要求:brief.md 写明使命、背景、约束、非目标、先问规则与完成条件;plan.md 是核心评审计划,需说明做什么、为何采用该方案、如何实现、实施切片、风险、阶段边界与验收标准,重要验收项须有可观察证据;verification.md 列出确切验证命令与人工检查、通过条件及证据记录位置;blockers.md 记录待决问题、用户决策点、需批准的危险操作与暂停条件;goal-prompt.md 给出可粘贴到 Codex 的最终命令,引用目标包文件为持久事实来源,要求把证据追加到 progress.jsonl,并定义何时停止或提问。

限制:不得跳过关键文档的评审门,不得因文档看似合理就标记就绪;最终提示词应避免开放式改进循环、混合无关任务、无量化证明的模糊表述、永久运行指令和未写入文件的隐藏假设。资料未提供具体安装方式、收费或平台支持信息。