SuperAPI AI 工具集

orient

办公与效率

查看项目

更新于 10-16 06:46

技能介绍

用途:Orient 提供一个只读的会话定位简报,回答“我们处于什么位置、正在做什么、为什么”。它结合本次对话与对话本身不掌握、但落盘且在线程外运行的状态——handoff 存档点、工作流检查清单、running-retro 账本、开放 pull request 与 work-item,以及 git 状态。它只做定位,不改变任何东西。与内置 /recap 不同:/recap 只总结对话且空闲时自动触发,不读取磁盘持久状态和线程外工作;本技能同时补上这层。/recap 无法被技能调用,故对话摘要在技能内联综合。

主要能力(全部只读):收集上下文——用独立 Bash 调用分别执行 printenv CLAUDE_CODE_SESSION_ID、git branch --show-current、git log --oneline -8、git status --porcelain(最多前 20 条),任一失败按未知值处理并继续;这些在运行时收集而非预计算,因 worktree 隔离的智能体拒绝含 $ 展开的命令(见 #1687)。读取持久记忆——通过插件绑定解析位置(${CLAUDE_PLUGIN_ROOT}/reference/topic-docs.md),按最近优先读取 handoffs/、<slug>/、running-retros/,位置缺失时静默降级。读取仓库与线程外状态——上述 git 上下文,以及工具存在时读取开放 PR(gh pr list)、开放 work-item 和线程外工作概览(${CLAUDE_PLUGIN_ROOT}/reference/off-thread-work.md);工具缺失或未认证时降级并说明。

输出:四部分简报——目标/原因、当前状态、已做决策及理由、方向与在飞事项(含开放 PR、线程外工作概览)。每条结论都须基于本轮读取;持久状态与对话冲突时暴露差异并指向 /session-flow:reanchor 核验。

边界:不写文件、不写记忆、不 /clear;不验证新鲜度(交给 reanchor);不恢复线程外工作(交给 keep-going);不规定下一阶段(交给 workflow);不计分或沉淀(交给 retro);不发起 handoff;不调用内置 /recap,而是内联综合对话摘要。

限制与注意:持久状态可能过期,应表述为“handoff 声称 X”而非当前事实;可选工具 gh、tracker CLI 可能缺失或未认证,不得因缺失来源阻塞简报;线程外工作仅概览,一旦要求“恢复”或“是否卡住”应改用 /session-flow:keep-going。