SuperAPI AI 工具集

leaf-fall

智能体与模型

查看项目

更新于 10-15 22:14

技能介绍

用途:LEAF Fall 负责把活跃工作项(leaf)从 .leaf/02-leaves/<slug>/ 移入 .leaf/03-fallen/<slug>/,使其退出活跃携带集合。它是“丢弃/归档”动作,不是引用或长期参考面。

主要能力与边界:只在 .leaf/ 内工作;使用命令 leaf fall <slug> --reason <reason> 完成生命周期移动;不读取、写入、推断或校验 .wt/ 文件;不创建 wt TaskDocument、工作流、分支、PR、提交、工单或执行产物;不因执行结束就关闭 leaf,需等 review/sync 与足够的回顾性收尾记录后才可落叶;不混淆 seed 状态与 fallen 状态,killed 或 deferred 属于 .leaf/01-seeds/<slug>/,fallen 属于已提交的 .leaf/02-leaves/<slug>/。

使用方式:先读取同级 ../leaf-soul/SKILL.md,遵循其共享行为、概述优先报告、事实与猜测分离、评审交接与语言偏好。动手前检查本地真实状态:git status --short --branch 与 find .leaf/02-leaves .leaf/03-fallen -maxdepth 1 -mindepth 1 -type d 2>/dev/null | sort。若 .leaf/02-leaves/<slug>/ 不存在则停止;若 .leaf/03-fallen/<slug>/ 已存在则停止,不合并、不覆盖。落叶前确认:用户明确要关闭该活跃 leaf;能说出落叶原因(如 completed、abandoned、superseded、parked、split、invalidated);工作进入执行或外部评审时存在 04-Feedback/09-review.md 或等效评审/同步记录;存在 04-Feedback/10-retrospect.md,或能在 CLI 移动前后写一份最小收尾说明;后继 seed 或 leaf 仅以路径链接,不自动创建。CLI 只写灵活状态槽,AI 应在有上下文时补充有用收尾内容。

执行与补充:运行 leaf fall <slug> --reason "<reason>",随后在上下文支持时丰富 .leaf/03-fallen/<slug>/00-status.md,包括收尾摘要、可复用经验、未解决限制、可选后继路径。若缺少 04-Feedback/10-retrospect.md,创建一份简洁回顾,含上述四字段及导致关闭的证据,并保持原始措辞、未知项、标准、线框、设计、任务图、评审记录、参考与回顾产物完整。

报告:按 ../leaf-soul/SKILL.md 概述优先、平实语言、已验证事实与假设分开,包含 fallen 路径、已不存在的源路径、落叶原因、已填或有意留空的收尾字段、fallen 中可检查的文件,以及确认未创建 .wt/ 或执行产物。

限制:资料未提供该技能的收费、价格、平台支持范围或效果数据;其行为严格限定在 .leaf/ 目录内,且依赖 LEAF 家族其他技能(如 leaf-soul)的共享约定。