命令 Manage

/dr-addskill

创建或更新技能、智能体和命令

概述

/dr-addskill 通过创建新的技能、智能体或命令——或更新现有内容——来扩展 Datarim 框架。技能创建者智能体会研究最佳实践,审计当前框架是否存在重叠,确定正确的范围(项目本地扩展或框架拉取请求),并生成格式正确的产物。

用法

/dr-addskill "Docker 部署最佳实践"
/dr-addskill "室内设计规范技能"
/dr-addskill "Python 项目的代码评审智能体"

功能说明

  1. 解析请求 — 理解需要哪个领域或能力,以及它应该是技能、智能体、命令还是组合。
  2. 研究 — 搜索目标领域的最佳实践,检查社区仓库中现有的 Claude Code 技能模式,并下载 2-3 个相关示例作为参考。
  3. 审计现有框架 — 列出所有当前技能、智能体和命令。检查该需求是否已被完全或部分覆盖。决定:新建、更新现有,还是扩展和补充。
  4. 确定范围 — 使用显式初始化的项目:本地扩展放在 .datarim-runtime/local/ 下,技能通过项目原生客户端发现目录暴露。可复用的框架变更以拉取请求形式提交到源仓库。不支持全局(用户级)安装。
  5. 设计 — 按照 Datarim 约定创建产物:
    • 技能:YAML frontmatter + 结构化 markdown 章节,少于 500 行
    • 智能体:包含必需 model 字段的 frontmatter + 角色声明 + 能力
    • 命令:frontmatter + 指令 + 后续步骤
  6. 提交审批 — 展示将创建或更新哪些文件、为何选择此结构,以及如何调用新能力。在写入任何内容前等待批准。
  7. 测试技能 — 对于纪律约束型技能,执行 RED → GREEN → REFACTOR 流程:在没有技能的情况下观察失败,编写能回应所捕获合理化借口的最小技能,然后重新运行直到不再出现新的漏洞。
  8. 应用并确认 — 创建目录并写入文件。报告已安装的内容、如何使用,以及是否需要重新加载。

参数

所需能力的描述。必填。

质量标准

  • 描述是触发器,不是摘要——为模型而写:“我应该在何时触发?”
  • 不陈述显而易见的内容——聚焦于推动 Claude 脱离其默认行为的内容
  • 不强制规定——给出目标和约束,而非规定性的分步说明
  • 包含 Gotchas 章节,提供最高信号量的模型指导
  • 每个技能文件少于 500 行

示例会话

> /dr-addskill "数据库迁移安全检查清单"

正在研究:数据库迁移最佳实践...
  找到:3 个相关的社区技能示例
  分析:零停机迁移模式

审计结果:
  现有技能:79
  相关:compliance.md(部分重叠)
  决定:创建新技能,从 compliance.md 引用

范围:项目本地(.datarim-runtime/local/)

拟议文件:
  1. .datarim-runtime/local/skills/db-migration/SKILL.md(新建,120 行)
  2. .datarim-runtime/local/skills/compliance/SKILL.md(更新:添加引用)

安装?(y/n)

相关命令

报告结果

在面向人员的更新或结果之前,应用人类结果报告。说明用户可见的结果、原始条件、检查与证据,以及未解决的限制。阶段结果并不意味着整个任务已完成。保持精确的协议和技术记录完整。如需在不继续工作的情况下再次解释,请使用 /dr-explain。