SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场levelup-specify

levelup-specify

智能体与模型

查看项目

更新于 10-16 02:09

技能介绍

levelup-specify 是一个用于从当前会话中提取可复用模式并记录为 CDR 的技能，属于 tikalk/adlc-team-skills。以下依据资料整理。

【用途】 这是一个在完成工作后从当前会话中提取上下文指令记录（CDR）的主要命令，用于捕获已完成工作中的经验教训。与 /levelup-init 的区别是：/levelup-init 从已有代码库中发现模式（棕地），而 levelup-specify 从当前会话中提取模式（绿地），聚焦于会话级别的学习成果。

【主要能力】

  1. 直接回顾当前会话（智能体记得自己做了什么）。
  2. 识别可复用模式：规则、人物角色、示例、技能和章程修订。
  3. 对每条指令类 CDR，提取一个配对的评估（eval）CDR，包含会话中的通过/失败用例。
  4. 将 CDR 链接到具体实现证据（文件、提交、测试）。
  5. 将 CDR 写入 {REPO_ROOT}/.adlc/drafts/cdr/CDR-{NNN}.md，状态为 Proposed。
  6. 自动生成 {REPO_ROOT}/.adlc/drafts/cdr/cdr.md 索引。

【使用方式】 命令接受用户输入 $ARGUMENTS，需在继续前考虑该输入（若非空）。输入示例：“Focus on error handling patterns”（聚焦错误处理模式）、“Document the testing approach”（记录测试方法）、“CDR-001”（用更多会话证据充实已有 CDR）、“--focus skills”（仅提议技能类 CDR）。空输入：提取会话中的所有模式。

标志（Flags）： --focus AREA：聚焦特定上下文类型，可选 rules（仅提议规则 CDR）、personas（仅提议人物角色 CDR）、examples（仅提议示例 CDR）、constitution（仅提议章程修订 CDR）、skills（仅提议技能 CDR）。 --cdr-id ID：用会话证据充实已有 CDR，而非创建新 CDR。

执行步骤分为多个阶段：

  • Phase 0 环境设置：运行 skills 基础目录中的 scripts/bash/setup-levelup-specify.sh，解析 JSON 输出中的路径与下一个 CDR 编号。若脚本不可用或失败，则手动解析路径：REPO_ROOT（从 cwd 向上查找含 .adlc/ 的目录，或用 git rev-parse --show-toplevel，或用 pwd）；TEAM_AI_DIRECTIVES（检查环境变量、REPO_ROOT/.adlc/init-options.json 的 team_ai_directives 字段，回退到 REPO_ROOT/team-ai-directives）；CDR_DRAFTS_DIR 为 REPO_ROOT/.adlc/drafts/cdr；NEXT_CDR 列出 CDR_DRAFTS_DIR/CDR-*.md，取最高编号加一，补零至三位。若 TEAM_AI_DIRECTIVES 未配置，提示运行 team-setup 或设置环境变量。
  • Phase 1 回顾会话：识别用户请求、智能体操作、结果、创建/修改的文件（git diff --stat、git log --oneline -10、git status --short）以及浮现的可复用模式，并收集实现证据。
  • Phase 1.5 写入会话追踪：将紧凑追踪写入 {REPO_ROOT}/.adlc/drafts/trace.md 作为审计轨迹，包含生成日期、分支、摘要、关键决策、变更文件。
  • Phase 2 加载已有 CDR：读取 CDR_DRAFTS_DIR/CDR-*.md；若提供 --cdr-id 则加载该 CDR 进行充实，否则加载所有待处理 CDR（状态 Discovered/Proposed）以避免重复。
  • Phase 3 提取模式：按上下文类型查找可复用模式——规则（编码约定、错误处理、测试模式、安全实践）、人物角色（实现中出现的角色，如 API consumer、DevOps operator）、示例（值得复用的代码模式）、技能（可打包为智能体技能的能力，尤其是可复用工作流）、章程修订（会话中发现的跨领域原则）。技能类 CDR 可由 levelup-specify 提议，实际 SKILL.md 稍后由 /levelup-publish --skill <name> 构建。评估 CDR：对每条指令 CDR（规则、人物角色、示例、章程）提取配对的评估 CDR，包含二元通过/失败用例：通过用例（智能体正确遵循隐式模式的时刻）、失败用例（智能体违反模式的时刻，常是指令创建的触发因素）、对抗用例（指令应处理的会话上下文边界情况）。每个用例自包含，包含场景、输入上下文、智能体输出以及通过/失败原因，不依赖外部追踪文件，证据内联。评估 CDR 使用 ### Context Type: Eval，并通过 ### Paired Directive CDR: CDR-NNN 引用其配对的指令 CDR。
  • Phase 4 创建/充实 CDR：为每个提取的模式创建或充实 CDR，包含标题、状态 Proposed、日期、来源、目标模块、上下文类型、描述符、上下文、证据（会话、分支、实现证据：文件/路径、提交 SHA）、决策。评估 CDR 格式包含配对指令 CDR、通过用例、失败用例（含修正）、对抗用例、证据。充实已有 CDR 时，追加到证据部分并更新充实时间戳。
  • Phase 5 重新生成索引：列出所有 CDR-*.md 文件并构建 markdown 表格，每行提取 ID、目标模块、类型、状态、创建日期、描述符等单行字段，并显示 Stats 与最后更新日期。
  • Phase 6 总结：展示会话、日期、创建/充实的 CDR 数量、按类型的 CDR 计数、交接信息（JSON 格式，含 source、command、cdrs_created、cdrs_enriched、next）以及后续步骤。

【何时使用】

  • 完成工作后：从会话中捕获可复用模式。
  • 回馈团队 AI 指令：将会话工作转化为可复用指令。
  • 关闭分支前：提取团队范围的经验教训。 注意：例行决策捕获由 team-boot 的持续捕获机制处理，直接写入 .adlc/drafts/。本技能用于交互式深入探索——当你想在记录前进行引导式权衡分析、多方案比较或结构化决策引导时。

【何时不使用】

  • 棕地项目：使用 /levelup-init 扫描已有代码。
  • 挖掘 git 历史 / 问题关联变更：使用 /change-init 从提交与问题追踪器中恢复过往决策。
  • 工作完成前：在实现完成后运行本技能。
  • 例行团队 AI 指令验证：使用 /team-repair 进行健康检查。

【关键规则】

  • 链接证据而非编造：每条 CDR 必须链接到具体会话证据，引用具体文件路径、提交 SHA 或测试用例，不得编造证据。
  • 避免重复：创建新 CDR 前检查已有 CDR；若存在相似模式，则充实而非重复。
  • 技能 CDR 是记录而非技能：levelup-specify 创建 Context Type: Skill 的 CDR，不直接创建 SKILL.md 文件；技能产物由 /levelup-publish --skill <name> 构建。
  • 信号门（Signal Gate）稍后应用：从会话证据中慷慨创建 CDR；信号门（团队范围、高价值、独特、证据）在 /levelup-publish 时应用。

【工作流与转换】 完整 CDR 生命周期：智能体会话（工作完成）→ /levelup-specify（回顾会话、写入追踪、提取 CDR）→ 提取模式 + 配对评估 → 将 CDR 写入 .adlc/drafts/cdr/CDR-{NNN}.md（Proposed）→ 运行 /levelup-clarify（审查并接受/拒绝 CDR，评估门运行已有黄金集）→ 运行 /levelup-publish（将接受的 CDR 编译为 team-ai-directives PR）→ 运行 /team-repair（合并后重新索引并验证团队 AI 指令）。

【验证】

  • CDR 写入 {REPO_ROOT}/.adlc/drafts/cdr/CDR-{NNN}.md，状态为 Proposed。
  • 审计追踪写入 {REPO_ROOT}/.adlc/drafts/trace.md。
  • 自动生成的 cdr.md 索引存在于 {REPO_ROOT}/.adlc/drafts/cdr/。
  • 每条 CDR 包含会话实现证据。
  • 评估 CDR 与其指令 CDR 配对，并包含自包含的通过/失败用例。
  • 适用时充实已有 CDR 而非重复。

【配置】

  • TEAM_AI_DIRECTIVES：团队 AI 指令路径（覆盖 .adlc/init-options.json）。
  • .adlc/init-options.json：项目级配置文件，含 team_ai_directives 字段。
  • 默认回退：相对于项目根目录的 team-ai-directives/。

【12-Factor 对齐】 Factor IX（可追溯性）——从会话证据中提取可复用模式，用于团队范围贡献。

【限制】 本技能不创建 SKILL.md 文件，仅创建 CDR；不扫描已有代码库（那是 /levelup-init 的职责）；不挖掘 git 历史（那是 /change-init 的职责）；CDR 处于 Proposed 状态，在被接受前无法发布。