技能 Core

演进

提出并应用框架改进的规则。涵盖成长(新增组件)与维护(修剪、合并)。自主决策使用门禁;交互式决策仍由人完成。

概述

演进规定了 Datarim 如何通过两条路径随时间自我改进:成长(在 /dr-compliance 或 /dr-archive 的 Step 0.5 回退中,通过 reflecting 技能提出新组件)与维护(通过 /dr-optimize 进行修剪、合并和效率改进)。在自主运行中,智能体在通过必需门禁后逐项决定每个提案,并记录结果。交互式运行保留人工选择。Class B 在应用前需要 PRD 草稿和独立盲审。

成长路径

每个任务完成后,反思阶段会分析经验教训,并可能提出改进:用新模式更新现有技能、完善智能体能力、为重复出现的模式添加模板,或为尚未覆盖的领域创建新技能。每个提案包含类别、目标文件、内容/原因/影响以及差异预览。

维护路径

优化器智能体执行全面审计:构建命令、智能体和技能的依赖图;检测未使用、过大、重复和损坏的组件;并生成优化提案——修剪、合并、拆分、重写或修复引用。

反臃肿规则

始终优先更新现有文件,而非创建新文件。在提出新技能之前,检查现有技能能否吸收该内容。框架臃肿会降低智能体性能——每个新文件都会增加上下文加载开销。

健康指标

  • 技能总数 > 20 触发优化建议
  • 智能体总数 > 18 触发优化建议
  • 命令总数 > 25 触发重复检查
  • 任何技能 > 500 行应拆分
  • 描述总字符数 > 8000 触发缩短
  • 任何单条描述 > 155 个字符应缩短
  • 孤立率 > 15% 触发修剪

Class A 与 Class B 门禁

并非所有提案都等价。Class A(内容变更——添加配方、修正描述、更新技能)可在技术门禁通过后应用。Class B(运行模型变更——事实来源方向、同步语义、流水线路由、核心契约)在应用前需要更新 PRD 并进行独立盲审。该门禁是在 <TASK-ID>/<TASK-ID> 之后引入的,当时一项研究结论被当作普通提案处理,导致 6 小时的方向性错误工作。

从反思到待办

自学习循环记录每个提案及其证据。自主运行在技术门禁之后决定应用、拒绝或推迟;交互式运行则询问人工。框架源码变更经过分支、PR、评审和 CI。消费方变更保留在项目本地覆盖层中,并记录为晋升候选。仅凭提案永远不能证明已应用。

弃用模式

当某个概念或命令被移除/重命名时,在历史引用中使用前向指针注释,而不是重写历史。删除活跃产物,用新名称扫描所有规范/文档文件,并通过引用版本和任务 ID 的注释保留历史提及。扫描测试可防止意外重新引入。

回滚

每次演进变更都是对特定文件的离散编辑。对于被修剪的组件,备份保存到 documentation/archive/optimized/。变更设计为可独立回滚——如果两个提案修改同一文件,它们将作为单独的编辑应用。