SuperAPI AI 工具集

goal

编程与开发

查看项目

更新于 10-16 06:22

技能介绍

用途:作为 /goal 模式旁的持久执行记忆。PRD 说明应该变成什么,目标账本记录执行过程中当前真实的状态,保持账本小巧可导航,使压缩、中断或链式目标不丢失执行现实。

主要能力:使用单一可读状态文件 implementation-notes.html 作为规范状态与历史,内嵌 progressEvents 进度时间线,无需单独 JSONL 日志。默认布局为 .agent/GOALS.md、runs/<goal-id>/GOAL.md、implementation-notes.html 及可选 evidence/。GOAL.md 是契约,含目标、完成标准、父目标、运行时目标耦合行与逃生舱。implementation-notes.html 含 Resume Here 顶部区、当前阶段、已完成/进行中工作、阻塞、下一步精确动作、决策、权衡、验证状态、受保护路径与下一目标候选。

使用方式:先定义完成标准,选稳定 goal-id,用脚本创建账本:uv run scripts/init_goal_ledger.py --root . --goal-id "<goal-id>" --title "<short title>" --objective "<one sentence objective>" --mode light;多步目标用 --mode full,链式目标加 --parent "<previous-goal-id>"。脚本不可用时手动创建相同文件。用户明确要求 $goal、/goal 模式等且运行时提供原生 goal 工具时,先创建文件账本,再调用原生工具,并把账本绝对路径写入目标描述。

适用场景:长时间编码、压缩恢复、链式工程目标、代码库状态追踪、实现笔记。

限制:仅在用户要求 goal 模式时创建原生运行时目标;原生工具不可用时继续用文件账本并说明无法创建运行时耦合。状态用 [todo]、[doing]、[done]、[blocked]、[incomplete]、[abandoned],[incomplete] 需附原因、证据、尝试、影响与下一步决策。每个严肃目标须含逃生舱。