Clavix

将代理提示工作流作为技能使用。可与任何兼容 agentskills.io 的 AI 工具配合使用。

安装

npm install -g clavix
clavix init

在设置过程中选择 Agent Skills。您可以选择全局范围（~/.config/agents/skills/）或项目范围（.skills/）。

技能

技能	用途
clavix-improve	通过六维度质量评估优化提示
clavix-prd	通过战略性问题生成产品需求文档
clavix-plan	根据产品需求文档创建任务分解
clavix-implement	执行任务并跟踪进度
clavix-start	开始对话式探索
clavix-summarize	从对话中提取需求
clavix-refine	更新现有产品需求文档或提示
clavix-verify	根据需求验证实现情况
clavix-review	使用预设标准审查拉取请求
clavix-archive	归档已完成项目

工作流程

快速：      clavix-improve → clavix-implement
完整：       clavix-prd → clavix-plan → clavix-implement → clavix-verify
探索性：     clavix-start → clavix-summarize → clavix-plan

工作原理

1. 您运行 clavix init – 技能会以包含 SKILL.md 文件的目录形式安装。
2. 您调用某项技能 – 您的 AI 工具会加载该技能的说明。
3. 代理按照工作流程执行 – 利用其原生工具。
4. 输出保存在本地 – 存放在 .clavix/outputs/ 目录下。

技能调用过程中不会执行任何代码。Markdown 模板本身就是最终产物。

其他集成

Clavix 还支持那些尚未支持 Agent Skills 的工具的特定集成：

类别	工具
集成开发环境	Cursor, Windsurf, Kilocode, Roocode, Cline, GitHub Copilot
命令行代理	Claude Code, Gemini CLI, Qwen, Droid, CodeBuddy, OpenCode, LLXPRT, Amp, Crush, Codex, Augment, Vibe
通用工具	AGENTS.md, OCTO.md, WARP.md

运行 clavix init 并选择您的工具。命令格式因工具而异：

• 命令行工具（Claude Code、Gemini）：/clavix:improve
• IDE 插件（Cursor、Copilot）：/clavix-improve

命令行命令

命令	用途
clavix init	初始化或重新配置集成
clavix update	重新生成模板
clavix diagnose	检查安装状态
clavix version	显示版本号

文档

• 命令参考
• 集成指南
• 架构说明
• 入门指南

系统要求

• Node.js >= 18.0.0
• 一款 AI 编程工具

许可证

Apache-2.0

星标历史

Clavix 快速上手指南

Clavix 是一个将“代理提示工作流”转化为标准化技能（Skills）的开源工具。它兼容任何支持 agentskills.io 规范的 AI 编程工具，帮助开发者通过预设的工作流（如需求分析、任务拆解、代码实现、验证审查）高效完成开发任务。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• Node.js: 版本需 >= 18.0.0
• AI 编程工具: 需安装任意一款支持的 AI 工具（如 Cursor, Windsurf, Claude Code, GitHub Copilot 等）
• 包管理器: 确保 npm 可用

提示：国内用户若遇到 npm 安装缓慢问题，可临时切换至国内镜像源：

npm config set registry https://registry.npmmirror.com

安装步骤

1. 全局安装 Clavix 在终端执行以下命令安装 CLI 工具：

   npm install -g clavix
   

2. 初始化配置 运行初始化命令，根据向导选择 Agent Skills 模式：

   clavix init
   

   • 作用域选择：您可以选择全局安装（~/.config/agents/skills/）或仅当前项目生效（.skills/）。
   • 工具集成：如果您使用的工具尚未原生支持 Agent Skills（如某些 CLI 工具或 IDE），clavix init 会引导您选择对应的集成方案（如 Cursor, Claude Code 等），并生成相应的调用指令格式。

基本使用

Clavix 的核心在于通过预定义的“技能”驱动 AI 代理执行标准化工作流。技能本质上是包含指令的 Markdown 模板，不会执行任何代码，确保安全可控。

1. 最简单的使用示例：优化提示词

假设您有一段初步的提示词想要优化，可以使用 clavix-improve 技能。

• 在支持的 IDE (如 Cursor, Copilot) 中： 直接在对话框输入：

  /clavix-improve
  

  随后粘贴您需要优化的提示词内容。

• 在支持的 CLI 工具 (如 Claude Code, Gemini CLI) 中： 输入斜杠命令：

  /clavix:improve
  

AI 将加载该技能的指令，按照“六维度质量评估”标准为您优化提示词，输出结果通常保存在 .clavix/outputs/ 目录下。

2. 典型工作流示例

您可以根据项目阶段组合使用不同的技能：

• 快速开发模式（优化提示词 -> 直接实现）： 依次调用 clavix-improve 和 clavix-implement。

• 完整项目模式（生成需求文档 -> 拆解任务 -> 实现 -> 验证）： 依次调用：

  1. clavix-prd：通过战略提问生成产品需求文档 (PRD)。
  2. clavix-plan：基于 PRD 创建任务分解列表。
  3. clavix-implement：执行具体任务并跟踪进度。
  4. clavix-verify：对照需求验证实现结果。

• 探索性模式（对话探索 -> 总结需求 -> 规划）： 依次调用 clavix-start -> clavix-summarize -> clavix-plan。

常用管理命令

命令	说明
clavix update	重新生成技能模板文件
clavix diagnose	检查安装状态和健康度
clavix version	查看当前版本号

更多详细指令参考官方文档或运行 clavix --help。