命令
Manage
/dr-addskill
创建或更新技能、智能体和命令
概述
/dr-addskill 通过创建新的技能、智能体或命令——或更新现有内容——来扩展 Datarim 框架。技能创建者智能体会研究最佳实践,审计当前框架是否存在重叠,确定正确的范围(项目本地扩展或框架拉取请求),并生成格式正确的产物。
用法
/dr-addskill "Docker 部署最佳实践"
/dr-addskill "室内设计规范技能"
/dr-addskill "Python 项目的代码评审智能体"
功能说明
- 解析请求 — 理解需要哪个领域或能力,以及它应该是技能、智能体、命令还是组合。
- 研究 — 搜索目标领域的最佳实践,检查社区仓库中现有的 Claude Code 技能模式,并下载 2-3 个相关示例作为参考。
- 审计现有框架 — 列出所有当前技能、智能体和命令。检查该需求是否已被完全或部分覆盖。决定:新建、更新现有,还是扩展和补充。
- 确定范围 — 使用显式初始化的项目:本地扩展放在
.datarim-runtime/local/下,技能通过项目原生客户端发现目录暴露。可复用的框架变更以拉取请求形式提交到源仓库。不支持全局(用户级)安装。 - 设计 — 按照 Datarim 约定创建产物:
- 技能:YAML frontmatter + 结构化 markdown 章节,少于 500 行
- 智能体:包含必需 model 字段的 frontmatter + 角色声明 + 能力
- 命令:frontmatter + 指令 + 后续步骤
- 提交审批 — 展示将创建或更新哪些文件、为何选择此结构,以及如何调用新能力。在写入任何内容前等待批准。
- 测试技能 — 对于纪律约束型技能,执行 RED → GREEN → REFACTOR 流程:在没有技能的情况下观察失败,编写能回应所捕获合理化借口的最小技能,然后重新运行直到不再出现新的漏洞。
- 应用并确认 — 创建目录并写入文件。报告已安装的内容、如何使用,以及是否需要重新加载。
参数
所需能力的描述。必填。
质量标准
- 描述是触发器,不是摘要——为模型而写:“我应该在何时触发?”
- 不陈述显而易见的内容——聚焦于推动 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-optimize — 添加技能后审计框架
- /dr-help — 验证新命令出现在列表中
报告结果
在面向人员的更新或结果之前,应用人类结果报告。说明用户可见的结果、原始条件、检查与证据,以及未解决的限制。阶段结果并不意味着整个任务已完成。保持精确的协议和技术记录完整。如需在不继续工作的情况下再次解释,请使用 /dr-explain。