/dr-addskill 命令 — 扩展 Datarim 框架
了解 /dr-addskill 如何研究最佳实践、审计现有组件,并为 Datarim 生成新的技能、代理和命令——在写入任何内容之前先经过 TDD 检查和栈无关性门禁。
Datarim 的设计目标是持续成长。当项目需要框架尚未具备的能力时——例如领域特定的 lint 检查、新的审查规范、专门的研究模式——/dr-addskill 会以正确的方式创建组件,而不是手工编写。Skill Creator 代理负责这项工作,运行在 Opus 级模型上,因为涉及的决策——创建什么、如何融入、分配哪个模型——都属于架构层面的决策。
在写入任何内容之前
该命令从研究开始。它会搜索目标领域的最佳实践,并检查社区技能仓库中是否有现成示例。然后审计当前框架:该需求是否已被覆盖,部分覆盖还是完全覆盖?如果现有技能只需更新而非新建文件,那么提出的就是更新方案。
对于旨在强制执行某种规范(而非教授某种技术)的技能,该命令会先运行一轮 TDD 检查。测试场景会演练该技能旨在防止的失败模式,在尚未加载该技能的代理上下文中运行。代理的合理化说辞会被逐字记录。随后编写的技能文本会明确回应每一条合理化说辞,而不是针对假设性的失败。重构轮次会在加载技能的情况下重新运行该场景,以确认没有新的合理化路径残留。
设计与模型分配
每个产物都遵循 Datarim 约定。技能带有 YAML frontmatter,包含 name、description,以及可选的 model 字段。代理必须包含 model 字段——约定区分了用于架构推理的 Opus、用于标准工作的 Sonnet,以及用于轻量工具的 Haiku。仅承载规则或模式的参考型技能省略 model 字段,并从调用上下文中继承。每个生成的描述都保持在两百五十个字符以内,因为过长的描述会降低可靠触发率。
该命令会展示提议的文件——路径和完整内容——并在写入任何内容之前解释结构性选择。需要获得批准。
栈无关性门禁
在将任何文件写入框架运行时(${DATARIM_RUNTIME}/{skills,agents,commands,templates}/)之前,栈无关性门禁会检查产物文本中是否引用了特定框架、语言或工具。例如,一个嵌入了 NestJS 特定逻辑的框架技能将无法通过门禁。提案会连同匹配到的关键词一起返回;作者需将其改写为栈中立的内容,或将其保留为项目本地扩展。这样可确保共享框架不包含特定生态系统的内容。
范围与确认
安装目标是显式初始化的项目。项目特定的新增内容放在 .datarim-runtime/local/ 下,并通过项目原生的客户端目录暴露(对于 Claude Code,为 .claude/skills/);可复用的框架变更以拉取请求的形式提交到源仓库。不再支持全局或用户级安装。该命令会创建必要的子目录,并确认安装了哪些内容、安装位置,以及是否需要新会话才能使变更生效。
添加技能后,运行 /dr-optimize 可检查其是否与现有组件重叠。在什么是 Datarim 中了解更多关于扩展框架的信息,或查看 Skill Creator 代理了解代理层面的视角。