dk-skills

dk-skills

公司内部 AI 编码 Agent 技能管理工具。通过统一 CLI 安装、更新、管理各 Agent 的技能包。

支持 OpenCode、Claude Code、Codex、Cursor 等 41 个 Agent。

快速开始

1. 配置认证

# 浏览器一键授权（推荐）
npx dk-skills auth

# 或直接传入 Key（适合 CI/CD）
npx dk-skills auth dk-ai-p-xxxxxxxxxxxxxxxx

auth 也可以写作 login，二者等价。认证 Key 保存在 ~/.acore/auth.json（用户级，所有项目共用）。

authKey 请前往 AI 中台 / AI 接口申请。

也可手动创建项目级 .acore/auth.json（优先级更高），格式：{ "authKey": "..." }。请将该文件加入 .gitignore，防止密钥泄露。

2. 安装技能

# 拉取全部可用技能，交互式选择安装
npx dk-skills add all

# 安装指定技能（按 slug）
npx dk-skills add baidu-api-test
npx dk-skills add baidu-api-test frontend-mandatory-standards

3. 更新技能

npx dk-skills update

安装命令

# 交互式选择安装
npx dk-skills add all

# 按 slug 安装一个或多个技能
npx dk-skills add <slug> [slug...]

选项

选项	说明
-a, --agent <agents...>	指定安装到哪些 Agent（例如 claude-code、kiro-cli）
-y, --yes	跳过所有确认提示

示例

# 安装到指定 Agent
npx dk-skills add baidu-api-test -a claude-code -a kiro-cli

# 非交互式安装（CI/CD）
npx dk-skills add baidu-api-test -y

安装范围

范围	标志	路径	说明
项目	（默认）	./<agent>/skills/	提交到仓库，团队共享
全局	-g	~/<agent>/skills/	当前用户所有项目均可用

更新命令

# 更新项目技能（自动检测范围）
npx dk-skills update

# 只更新项目级技能
npx dk-skills update -p

# 只更新全局技能
npx dk-skills update -g

# 跳过范围确认（非交互式）
npx dk-skills update -y

选项	说明
-g, --global	只更新全局技能
-p, --project	只更新项目技能
-y, --yes	跳过范围选择（有项目技能则更新项目，否则更新全局）
[skills...]	指定技能名，只更新匹配的技能

其他命令

命令	说明
npx dk-skills agents	列出所有支持的 Agent 及目录
npx dk-skills list	列出已安装的技能（别名：ls）
npx dk-skills remove [skills]	删除已安装的技能
npx dk-skills init [name]	创建新技能模板（SKILL.md）

查看支持的 Agent

# 终端友好格式（✓ 标记当前项目中已存在的目录）
npx dk-skills agents

# JSON 格式（供 AI/脚本解析）
npx dk-skills agents --json

输出示例：

Supported agents  (✓ = skill folder exists in current project)

  Agent            --agent            Project Dir
  ──────────────────────────────────────────────────
✓ Claude Code      claude-code        .claude/skills
  Cursor           cursor             .agents/skills
✓ Kiro CLI         kiro-cli           .kiro/skills
  ...

--json 输出可直接供 AI 读取，用于自动选择 -a 参数：

npx dk-skills agents --json
# [{"agent":"claude-code","displayName":"Claude Code","skillsDir":".claude/skills","exists":true}, ...]

列出技能

# 列出项目技能
npx dk-skills list

# 列出全局技能
npx dk-skills ls -g

# 按 Agent 筛选
npx dk-skills ls -a claude-code

删除技能

# 交互式选择删除
npx dk-skills remove

# 删除指定技能
npx dk-skills remove baidu-api-test

# 从指定 Agent 删除
npx dk-skills remove --agent claude-code baidu-api-test

# 删除所有技能
npx dk-skills remove --all

推送技能到平台

将本地编写的技能推送到 AI 中台，供其他人安装使用。

# 交互式（逐步引导）
npx dk-skills push

# 非交互式（一行完成，适合 AI/CI 场景）
npx dk-skills push --dir .claude/skills --skill my-skill --bump patch --changelog "修复问题" --auditor-id -1

CLI 会自动检测当前目录中存在的技能文件夹，引导完成以下步骤：

• 选择技能来源目录（如 .claude/skills、.agents/skills）
• 选择要推送的技能
• 首次推送：选择审核人 → 推送
• 更新推送：选择版本类型 → 填写变更说明 → 选择审核人 → 推送

参数说明

参数	说明
--skill <slug>	技能文件夹名
--dir <path>	技能目录，如 .claude/skills（有多个目录时用于指定）
--bump patch|minor|major	版本递增类型（更新时用）
--changelog <text>	变更说明，≤200 字（更新时用）
--auditor-id <id>	审核人 ID；-1 表示平台默认审核人
-y	非交互模式，有歧义时自动取第一项

版本类型

类型	示例	说明
patch	1.0.0 → 1.0.1	Bug 修复、措辞调整
minor	1.0.0 → 1.1.0	新增内容、非破坏性改动
major	1.0.0 → 2.0.0	重大重写或破坏性变更

注意事项

• 需先完成认证（dk-skills auth）
• 技能文件夹名即为平台 slug，请确保与 SKILL.md 中 name 字段派生一致
• slug 已被他人占用时无法推送，需更换文件夹名

兼容 Git 仓库安装

除公司内部技能外，仍支持从 GitHub / GitLab 仓库安装：

# GitHub 简写
npx dk-skills add vercel-labs/agent-skills

# 完整 URL
npx dk-skills add https://github.com/vercel-labs/agent-skills

# 指定仓库内某个技能
npx dk-skills add https://github.com/vercel-labs/agent-skills/tree/main/skills/web-design-guidelines

# 本地路径
npx dk-skills add ./my-local-skills

技能格式

技能是包含 SKILL.md 文件的目录，文件头部为 YAML frontmatter：

---
name: my-skill
description: 技能的简要说明
---

# My Skill

具体指令内容...

必填字段

• name：技能唯一标识（建议小写 + 连字符）
• description：简短描述

支持的 Agent

CLI 会自动检测已安装的 Agent。未检测到时会提示手动选择。

Agent	--agent	项目路径	全局路径
Amp, Kimi Code CLI, Replit, Universal	amp, kimi-cli, replit, universal	.agents/skills/	~/.config/agents/skills/
Antigravity	antigravity	.agents/skills/	~/.gemini/antigravity/skills/
Augment	augment	.augment/skills/	~/.augment/skills/
IBM Bob	bob	.bob/skills/	~/.bob/skills/
Claude Code	claude-code	.claude/skills/	~/.claude/skills/
OpenClaw	openclaw	skills/	~/.openclaw/skills/
Cline, Warp	cline, warp	.agents/skills/	~/.agents/skills/
CodeBuddy	codebuddy	.codebuddy/skills/	~/.codebuddy/skills/
Codex	codex	.agents/skills/	~/.codex/skills/
Command Code	command-code	.commandcode/skills/	~/.commandcode/skills/
Continue	continue	.continue/skills/	~/.continue/skills/
Cortex Code	cortex	.cortex/skills/	~/.snowflake/cortex/skills/
Crush	crush	.crush/skills/	~/.config/crush/skills/
Cursor	cursor	.agents/skills/	~/.cursor/skills/
Deep Agents	deepagents	.agents/skills/	~/.deepagents/agent/skills/
Droid	droid	.factory/skills/	~/.factory/skills/
Firebender	firebender	.agents/skills/	~/.firebender/skills/
Gemini CLI	gemini-cli	.agents/skills/	~/.gemini/skills/
GitHub Copilot	github-copilot	.agents/skills/	~/.copilot/skills/
Goose	goose	.goose/skills/	~/.config/goose/skills/
Junie	junie	.junie/skills/	~/.junie/skills/
iFlow CLI	iflow-cli	.iflow/skills/	~/.iflow/skills/
Kilo Code	kilo	.kilocode/skills/	~/.kilocode/skills/
Kiro CLI	kiro-cli	.kiro/skills/	~/.kiro/skills/
Kode	kode	.kode/skills/	~/.kode/skills/
MCPJam	mcpjam	.mcpjam/skills/	~/.mcpjam/skills/
Mistral Vibe	mistral-vibe	.vibe/skills/	~/.vibe/skills/
Mux	mux	.mux/skills/	~/.mux/skills/
OpenCode	opencode	.agents/skills/	~/.config/opencode/skills/
OpenHands	openhands	.openhands/skills/	~/.openhands/skills/
Pi	pi	.pi/skills/	~/.pi/agent/skills/
Qoder	qoder	.qoder/skills/	~/.qoder/skills/
Qwen Code	qwen-code	.qwen/skills/	~/.qwen/skills/
Roo Code	roo	.roo/skills/	~/.roo/skills/
Trae	trae	.trae/skills/	~/.trae/skills/
Trae CN	trae-cn	.trae/skills/	~/.trae-cn/skills/
Windsurf	windsurf	.windsurf/skills/	~/.codeium/windsurf/skills/
Zencoder	zencoder	.zencoder/skills/	~/.zencoder/skills/
Neovate	neovate	.neovate/skills/	~/.neovate/skills/
Pochi	pochi	.pochi/skills/	~/.pochi/skills/
AdaL	adal	.adal/skills/	~/.adal/skills/

[!NOTE] Kiro CLI 用户： 安装技能后，需手动将技能加入 .kiro/agents/<agent>.json 的 resources：

{
  "resources": ["skill://.kiro/skills/**/SKILL.md"]
}

环境变量

变量	说明
DISABLE_TELEMETRY	禁用匿名使用统计
DO_NOT_TRACK	同上，备用方式

License

MIT