@archon-claw/cli 0.5.0 → 0.6.0

package/dist/templates/workspace/.claude/skills/create-eval-case/SKILL.md

@@ -1,159 +0,0 @@
----
-name: create-eval-case
-description: 创建评估用例文件。当用户需要为 agent 编写 eval case 时使用。
-argument-hint: "[case_name]"
----
-
-在 `agents/my-agent/eval-cases/` 目录下创建评估用例文件。
-
-## 规范
-
-- 文件名格式：`<name>.eval.json`
-- 必须通过 `packages/cli/src/schemas/eval-case.schema.json` 的校验
-- 通过 `archon-claw eval <agent-dir>` 命令运行
-
-## 文件结构
-
-```
-agents/<agent-name>/
-├── eval-cases/                   # 评估用例
-│   ├── basic.eval.json
-│   └── tool-usage.eval.json
-└── eval-judges/                  # Judge 配置（可选）
-    ├── default.json
-    └── strict.json
-```
-
-## 三种评估模式
-
-### 1. `single` — 单轮评估
-
-只有 1 个 user turn，Agent 生成 1 次回复，对最终回复运行断言。
-
-```json
-{
-  "name": "计算器测试",
-  "mode": "single",
-  "turns": [
-    { "role": "user", "content": "帮我算一下 15 * 7" }
-  ],
-  "assertions": [
-    { "type": "contains", "value": "105" },
-    { "type": "tool-called", "value": "calculator" }
-  ]
-}
-```
-
-### 2. `injected` — 历史注入模式
-
-提供多轮历史，一次性注入上下文，只有最后一个 user turn 触发 LLM 生成。
-
-```json
-{
-  "name": "上下文理解",
-  "mode": "injected",
-  "turns": [
-    { "role": "user", "content": "我叫小明" },
-    { "role": "assistant", "content": "你好小明！" },
-    { "role": "user", "content": "我叫什么名字？" }
-  ],
-  "assertions": [
-    { "type": "contains", "value": "小明" }
-  ]
-}
-```
-
-### 3. `sequential` — 多轮对话模式
-
-每个 user turn 独立调用 LLM 生成回复，支持每轮独立断言。
-
-```json
-{
-  "name": "多步计算",
-  "mode": "sequential",
-  "turns": [
-    {
-      "role": "user",
-      "content": "帮我算 10 + 20",
-      "assertions": [{ "type": "contains", "value": "30" }]
-    },
-    {
-      "role": "user",
-      "content": "再乘以 3",
-      "assertions": [{ "type": "contains", "value": "90" }]
-    }
-  ],
-  "assertions": [{ "type": "contains", "value": "90" }]
-}
-```
-
-## 断言类型
-
-**文本断言：**
-
-| 类型 | 说明 | value 示例 |
-|------|------|-----------|
-| `contains` | 包含文本（不区分大小写） | `"105"` |
-| `not-contains` | 不包含文本 | `"error"` |
-| `regex` | 正则匹配 | `"\\d+\\.\\d+"` |
-| `length-min` | 长度 >= N | `"50"` |
-| `length-max` | 长度 <= N | `"500"` |
-| `json-valid` | 合法 JSON | `""` |
-
-**工具断言：**
-
-| 类型 | 说明 | value 示例 |
-|------|------|-----------|
-| `tool-called` | 调用了指定工具 | `"calculator"` |
-| `tool-not-called` | 未调用指定工具 | `"search"` |
-| `tool-called-with` | 调用工具且参数匹配 | `{"tool":"calculator","args":{"expression":"15*7"}}` |
-
-## Case 可选字段
-
-| 字段 | 类型 | 说明 |
-|------|------|------|
-| `expectedOutput` | string | 期望输出描述（给 Judge 参考） |
-| `tags` | string[] | 标签，用于 `--tag` 过滤 |
-| `tools` | string[] | 限制可用工具子集 |
-| `judge` | string | 指定 judge 配置名（如 `"strict"`），默认 `"default"` |
-
-## 模板
-
-```json
-{
-  "$schema": "../../../packages/cli/src/schemas/eval-case.schema.json",
-  "name": "测试套件名称",
-  "description": "测试说明",
-  "cases": [
-    {
-      "name": "用例名称",
-      "mode": "single",
-      "turns": [
-        { "role": "user", "content": "用户输入" }
-      ],
-      "assertions": [
-        { "type": "contains", "value": "期望包含的文本" }
-      ],
-      "tags": ["tag1"]
-    }
-  ]
-}
-```
-
-## 运行
-
-```bash
-archon-claw eval agents/my-agent
-archon-claw eval agents/my-agent --file basic.eval.json
-archon-claw eval agents/my-agent --tag tool-usage
-```
-
-## 注意
-
-- cases 数组至少包含 1 个用例
-- 每个 case 的 turns 至少有 1 个 turn
-- `injected` 模式最后一个 turn 必须是 `user`
-- `sequential` 模式 turns 中只有 `user` role 的 turn 会触发 LLM 生成
-- `tool-called-with` 的 value 是 JSON 字符串，需要转义
-
-请根据用户的需求创建评估用例文件。$ARGUMENTS

package/dist/templates/workspace/.claude/skills/create-eval-judge/SKILL.md

@@ -1,128 +0,0 @@
----
-name: create-eval-judge
-description: 创建 Judge 评审配置文件。当用户需要配置 LLM 评审规则时使用。
-argument-hint: "[judge_name]"
----
-
-在 `agents/my-agent/eval-judges/` 目录下创建 Judge 评审配置文件。
-
-## 规范
-
-- 文件名格式：`<name>.json`，如 `default.json`、`strict.json`
-- 必须通过 `packages/cli/src/schemas/eval-judge.schema.json` 的校验
-- 在 eval case 中通过 `"judge": "<name>"` 引用，不指定则使用 `default.json`
-
-## 文件结构
-
-```
-agents/<agent-name>/
-├── eval-cases/
-│   └── basic.eval.json           ← 可设置 "judge": "strict"
-└── eval-judges/
-    ├── default.json              ← 默认 judge
-    └── strict.json               ← 可选的其他 judge
-```
-
-## 维度类型
-
-### numeric — 数值评分（默认）
-
-按 min-max 范围打分，适合模糊评估：
-
-```json
-{ "key": "accuracy", "label": "准确性", "weight": 0.4, "min": 0, "max": 10 }
-```
-
-### binary — 二元判定
-
-只有 pass/fail（true/false），适合明确标准：
-
-```json
-{ "key": "correct", "label": "回答正确", "type": "binary", "weight": 0.5 }
-```
-
-二元维度在计算总分时，pass = 10 分，fail = 0 分，参与加权平均。
-
-## 模板
-
-```json
-{
-  "$schema": "../../../packages/cli/src/schemas/eval-judge.schema.json",
-  "model": {
-    "provider": "bailian",
-    "model": "qwen-plus"
-  },
-  "dimensions": [
-    { "key": "accuracy", "label": "准确性", "weight": 0.4, "min": 0, "max": 10 },
-    { "key": "relevance", "label": "相关性", "weight": 0.3, "min": 0, "max": 10 },
-    { "key": "clarity", "label": "清晰度", "weight": 0.3, "min": 0, "max": 10 }
-  ]
-}
-```
-
-## 混合维度示例
-
-数值和二元维度可以混用：
-
-```json
-{
-  "dimensions": [
-    { "key": "correct", "label": "回答正确", "type": "binary", "weight": 0.5 },
-    { "key": "tool_usage", "label": "工具使用正确", "type": "binary", "weight": 0.3 },
-    { "key": "clarity", "label": "清晰度", "weight": 0.2, "min": 0, "max": 10 }
-  ]
-}
-```
-
-## 自定义 Prompt 模板
-
-通过 `promptTemplate` 字段覆盖默认评审提示词，使用 LiquidJS 语法：
-
-```json
-{
-  "dimensions": [
-    { "key": "correct", "label": "正确", "type": "binary", "weight": 1 }
-  ],
-  "promptTemplate": "判断以下回复是否正确。\n\n问题：{{ user_input }}\n回复：{{ actual_response }}\n\n以 JSON 格式回复：\n{ \"correct\": { \"score\": true/false, \"reason\": \"理由\" } }"
-}
-```
-
-### 模板可用变量
-
-| 变量 | 说明 |
-|------|------|
-| `user_input` | 用户输入 |
-| `expected_output` | 期望输出（可能为空） |
-| `actual_response` | LLM 实际回复 |
-| `conversation` | 完整对话记录 |
-| `dimensions` | 维度数组（含 key/label/type/min/max） |
-
-`turnPromptTemplate` 用于 sequential 模式的每轮评审，可用变量相同。
-
-## 可选字段
-
-| 字段 | 类型 | 说明 |
-|------|------|------|
-| `model` | object | Judge 使用的模型（不填则用 agent 的 model） |
-| `promptTemplate` | string | 自定义评审提示词模板 |
-| `turnPromptTemplate` | string | sequential 模式每轮评审模板 |
-
-## 维度字段
-
-| 字段 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `key` | string | 是 | 维度标识（用于 JSON 输出） |
-| `label` | string | 是 | 维度显示名 |
-| `weight` | number | 是 | 权重（0-1） |
-| `type` | string | 否 | `"numeric"`（默认）或 `"binary"` |
-| `min` | number | 否 | 最低分（默认 0，仅 numeric） |
-| `max` | number | 否 | 最高分（默认 10，仅 numeric） |
-
-## 注意
-
-- dimensions 数组至少包含 1 个维度
-- 所有维度的 weight 之和建议为 1（不强制）
-- model 不填时使用 agent 自身的 model 配置
-- LLM 返回的 JSON 中 binary 维度为 `true`/`false`，会自动转换为 1/0
-
-请根据用户的需求创建 Judge 配置文件。$ARGUMENTS

package/dist/templates/workspace/.claude/skills/create-mcp-config/SKILL.md

@@ -1,151 +0,0 @@
----
-name: create-mcp-config
-description: 创建或修改 MCP 服务器配置文件。当用户需要连接外部 MCP 服务器、添加 MCP 工具时使用。
----
-
-创建或修改 `agents/my-agent/mcp.json` MCP 服务器配置文件。
-
-## 规范
-
-- 文件位于 Agent 配置文件夹根目录，文件名固定为 `mcp.json`
-- 该文件是可选的，不存在时 agent 只使用本地工具
-- MCP 工具会自动合并到 agent 的工具列表中，与本地工具无区别
-
-## 字段
-
-### 顶层
-
-| 字段 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `mcpServers` | object | 是 | 服务器配置，key 为服务器名称 |
-
-### 每个 server 配置
-
-| 字段 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `command` | string | stdio 时必填 | 可执行命令 |
-| `args` | string[] | 否 | 命令行参数 |
-| `env` | object | 否 | 环境变量，支持 `${VAR}` 引用 process.env |
-| `cwd` | string | 否 | 工作目录 |
-| `url` | string | SSE/HTTP 时必填 | 远程服务器 URL |
-| `headers` | object | 否 | HTTP 请求头 |
-| `transport` | string | 否 | `"stdio"` / `"sse"` / `"streamable-http"`，可自动推断 |
-| `enabled` | boolean | 否 | 设为 `false` 可禁用，默认 `true` |
-| `timeout` | number | 否 | 工具调用超时（毫秒），默认 30000 |
-| `tools` | object | 否 | 工具过滤配置 |
-
-### tools 过滤
-
-| 字段 | 类型 | 说明 |
-|------|------|------|
-| `include` | string[] | glob 模式白名单，只暴露匹配的工具 |
-| `exclude` | string[] | glob 模式黑名单，隐藏匹配的工具 |
-| `rename` | object | 重命名映射，如 `{"browser_navigate": "goto"}` |
-
-## Transport 自动推断
-
-- 有 `command` → `stdio`（本地进程通信）
-- 有 `url` → 先尝试 `streamable-http`，失败后自动 fallback 到 `sse`
-- 显式指定 `transport` 可跳过自动推断（如确定只用 SSE 时写 `"transport": "sse"`）
-- `command` 和 `url` 至少提供一个
-
-## 工具命名规则
-
-- 默认名称格式：`{serverName}__{toolName}`（避免冲突）
-- 通过 `rename` 可自定义名称（不加前缀）
-- 名称会自动规范化为 `^[a-z][a-z0-9_]*$`
-
-## 示例
-
-### 本地 stdio 服务器
-
-```json
-{
-  "mcpServers": {
-    "playwright": {
-      "command": "npx",
-      "args": ["@playwright/mcp@latest"],
-      "timeout": 60000,
-      "tools": {
-        "include": ["browser_*"],
-        "exclude": ["browser_install"]
-      }
-    }
-  }
-}
-```
-
-### 远程服务器（自动协商协议）
-
-只需提供 `url`，会先尝试 streamable-http，不支持则自动降级为 SSE：
-
-```json
-{
-  "mcpServers": {
-    "remote_api": {
-      "url": "https://my-server.com/mcp",
-      "headers": {
-        "Authorization": "Bearer ${API_TOKEN}"
-      }
-    }
-  }
-}
-```
-
-### 强制指定 SSE
-
-如果确定服务器只支持 SSE，可显式指定以跳过 streamable-http 尝试：
-
-```json
-{
-  "mcpServers": {
-    "legacy": {
-      "transport": "sse",
-      "url": "https://old-server.com/sse"
-    }
-  }
-}
-```
-
-### 多服务器配置
-
-```json
-{
-  "mcpServers": {
-    "filesystem": {
-      "command": "npx",
-      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/workspace"]
-    },
-    "github": {
-      "command": "npx",
-      "args": ["-y", "@modelcontextprotocol/server-github"],
-      "env": {
-        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
-      }
-    }
-  }
-}
-```
-
-## 在系统提示词中引用 MCP 工具
-
-MCP 服务器和工具会自动注入到 `system-prompt.md` 的 Liquid 模板变量 `mcp` 中，可按服务器名称访问：
-
-```markdown
-{% for tool in mcp.playwright.tools %}
-- {{ tool.name }}：{{ tool.description }}
-{% endfor %}
-```
-
-详见 `/create-system-prompt` 技能中的 `mcp 变量` 部分。
-
-## 注意
-
-- `command` 和 `url` 至少提供一个，否则校验失败
-- 环境变量中的敏感信息（API Key 等）用 `${VAR}` 引用，不要硬编码
-- 服务器连接失败不会阻止 agent 启动，只会打印警告
-- MCP 工具与本地工具同名时，本地工具优先（MCP 工具被跳过并打印警告）
-- 不要添加未定义的字段（strict 模式）
-- `mcpServers` 的 key（服务器名称）会作为 `mcp.{name}` 暴露给系统提示词模板
-
-请根据用户的需求创建或修改 MCP 配置。$ARGUMENTS

package/dist/templates/workspace/.claude/skills/create-model-config/SKILL.md

@@ -1,45 +0,0 @@
----
-name: create-model-config
-description: 创建或修改模型配置文件。当用户需要配置 LLM 模型、修改 model.json 时使用。
----
-
-创建或修改 `agents/my-agent/model.json` 模型配置文件。
-
-## 规范
-
-- 文件位于 Agent 配置文件夹根目录
-- 必须通过 `src/schemas/model.schema.json` 的校验
-
-## 字段
-
-| 字段 | 类型 | 必填 | 默认值 | 说明 |
-|------|------|------|--------|------|
-| `provider` | string | 是 | - | `"anthropic"` 或 `"openai"` |
-| `model` | string | 是 | - | 模型 ID |
-| `maxTokens` | number | 否 | 4096 | 最大输出 token 数 |
-| `temperature` | number | 否 | 0.7 | 采样温度，0~2 |
-| `apiKey` | string | 否 | - | API Key，优先用环境变量 |
-
-## 常用模型 ID
-
-Anthropic: `claude-sonnet-4-20250514`、`claude-opus-4-20250514`、`claude-haiku-4-5-20251001`
-OpenAI: `gpt-4o`、`gpt-4o-mini`
-
-## 示例
-
-```json
-{
-  "provider": "anthropic",
-  "model": "claude-sonnet-4-20250514",
-  "maxTokens": 4096,
-  "temperature": 0.7
-}
-```
-
-## 注意
-
-- `provider` 和 `model` 必填
-- `apiKey` 建议不写在文件里，用环境变量（`ANTHROPIC_API_KEY` / `OPENAI_API_KEY`）
-- 不要添加未定义的字段（`additionalProperties: false`）
-
-请根据用户的需求创建或修改模型配置。$ARGUMENTS

package/dist/templates/workspace/.claude/skills/create-skill/SKILL.md

@@ -1,63 +0,0 @@
----
-name: create-skill
-description: 创建 agent skill 技能。当用户需要为 agent 添加新的技能（如代码审查、解释代码等）时使用。
----
-
-在 `agents/my-agent/skills/` 目录下创建一个新的技能。
-
-## 规范
-
-- 创建 `skills/<skill-name>/SKILL.md` 文件
-- 必须通过 `src/schemas/agent-skill.schema.json` 的校验
-- frontmatter 必须包含 `name` 和 `description`
-- body 不能为空
-
-## 文件结构
-
-```
-skills/
-└── <skill-name>/
-    └── SKILL.md
-```
-
-## 格式
-
-```markdown
----
-name: skill-name
-description: 技能描述，说明什么场景下使用
----
-
-技能的具体指令内容...
-```
-
-## frontmatter 字段
-
-| 字段 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `name` | string | 是 | 技能名称 |
-| `description` | string | 是 | 技能用途描述 |
-
-## 示例
-
-```markdown
----
-name: code-review
-description: 对代码进行 review，检查潜在问题并给出改进建议
----
-
-对用户提供的代码进行审查，关注以下方面：
-
-1. **正确性**：逻辑是否正确
-2. **安全性**：是否有安全隐患
-3. **性能**：是否有明显的性能问题
-4. **可读性**：命名是否清晰
-```
-
-## 注意
-
-- `name` 和 `description` 都是必填的
-- body 内容是技能的具体指令，不能为空
-- 不要添加 `name` 和 `description` 以外的 frontmatter 字段
-
-请根据用户需求创建技能。$ARGUMENTS