用途
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 类决策。