SuperAPI AI 工具集

levelup-boot

智能体与模型

查看项目

更新于 10-16 07:29

技能介绍

用途

levelup-boot 是 team-boot 的 Class Boots 目录中五个 class boot 之一。team-boot 始终注入紧凑的 CDR 索引(ID、类型、描述符),因为团队上下文与任何任务都相关;levelup-boot 则是深度加载层——当任务匹配一个或多个描述符时,它从 team-ai-directives 加载完整的上下文模块正文,并结合决策捕获,使可复用的团队模式被记录下来(/levelup-specify),而不是仅停留在当前会话。

team-ai-directives 路径来自当前工作目录下的 .adlc/init-options.json(读取方式与 team-boot 相同:不要向上遍历父目录,不要搜索该文件)。

何时使用

在以下情况调用:

  • 任务匹配注入索引中的一个或多个 CDR 描述符,且紧凑描述符不够用——需要完整的规则/persona/示例正文才能正确应用。
  • 多个 CDR 看起来都相关,需要比较或协调(可能存在规则冲突)。
  • 会话产生了可复用的团队模式:“我们总是做 X”、新出现的规则、值得在团队中共享的 persona 或示例。
  • 为 /levelup-clarify 或 /levelup-publish 做准备,需要当前模块正文作为参考。

对于没有 CDR 匹配的任务不要调用——紧凑索引已经显示 0 匹配。

核心流程

步骤 1:解析指令路径

从当前工作目录读取 .adlc/init-options.json。

提取 team_ai_directives。如果缺失/为 null/不存在,报告团队级 CDR 深度加载不可用并继续;仅在用户希望配置指令时建议 /team-setup。

步骤 1b:读取 CDR 草稿索引

检查 .adlc/drafts/cdr/ 中 frontmatter 里 status: proposed 的 CDR-*.md 文件。这些是待澄清的草稿 CDR——尚未发布到 team-ai-directives 的拟议团队模式。从每个文件收集 ID / Title / Type / Status / Date。如果目录为空或不存在,报告 0 个待处理草稿。

步骤 2:读取匹配的模块正文

从注入的 CDR 索引中,取出描述符与当前任务匹配的行(即 Team Context in Use 表列出的相同行),读取 {TEAM_AI_DIRECTIVES}/context_modules/ 下对应的文件:

  • Persona 行 → personas/<name>.md
  • Rule 行 → rules/<domain>/<name>.md
  • Example 行 → examples/<...>/<name>.md

只读取匹配的模块——不要读取整棵树。

步骤 3:注入 CDR 深度加载(输出契约)

在任务回答之前输出:

CDR Deep-Dive

ID Module Key Directive
CDR-2026-021 rules/security/sql_injection_prevention Parameterized queries only; ...

Searched N CDRs, K matched.

Drafts Pending Review

ID Title Type Status Date
(from .adlc/drafts/cdr/)

N pending drafts — run /levelup-clarify to review.

每个匹配模块一行,将该模块的可执行规则浓缩为一到两句话(当规则是硬约束时更完整地引用)。

N = CDR 索引条目总数;K = 读取的模块数。K 必须等于表中显示的行数。

如果匹配的模块存在冲突,添加 Conflicting Guidance 说明并建议 /team-repair --conflicts。

步骤 4:捕获团队模式

触发 动作
出现可复用规则,“我们总是做 X” CDR → 直接写入 .adlc/drafts/cdr/
团队模式在多次会话中得到验证 CDR → 直接写入 .adlc/drafts/cdr/
值得共享的 persona/示例 CDR → 直接写入 .adlc/drafts/cdr/
CDR 类决策已在账本中 验证捕获已发生;若未发生,重新呈现

为本次会话检测到的每个 CDR 类决策,在 Session Decision Ledger(Decision | Type | Captured? | Skill)中添加/刷新行——包括在此 boot 被调用之前的决策。在会话结束时,提示对 .adlc/drafts/cdr/ 中任何未记录的 CDR 草稿运行 /levelup-clarify。

失败处理

  • 指令路径未配置 → 注明团队级深度加载不可用,继续任务;绝不阻塞。
  • 匹配的模块文件缺失 → 在表中注明((file missing))并建议 /team-repair。

危险信号

  • 读取整个 context_modules/ 树,而不是只读取匹配的模块。
  • 捏造模块内容——绝不捏造;表格必须总结实际读取的内容。
  • 注入深度加载上下文却忽略捕获——两者的配对才是重点。
  • 向上遍历父目录来查找 .adlc/ 或指令仓库。

验证

  • 已输出 CDR Deep-Dive 表,并带有 Searched N CDRs, K matched.(K = 读取的模块数)。
  • 只读取了匹配的模块。
  • Session Decision Ledger 已更新检测到的 CDR 类决策。