@archon-claw/cli 0.5.0 → 0.6.0

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

@@ -1,168 +0,0 @@
----
-name: create-system-prompt
-description: 创建或修改系统提示词。当用户需要编写 system-prompt.md 时使用。
----
-
-创建或修改 agent 的 `system-prompt.md` 系统提示词文件。
-
-## 规范
-
-- 文件位于 agent 配置文件夹根目录
-- 内容不能为空
-- 支持 Liquid 模板语法引用 datasets/ 和 skills/ 中的数据
-- 模板语法会在启动时由 liquidjs 解析验证
-
-## Liquid 模板变量
-
-### datasets 变量
-
-datasets/ 中的文件名（去掉 `.json`）即为变量名：
-
-```markdown
-{% for rule in rules %}
-- {{ rule }}
-{% endfor %}
-```
-
-### skills 变量
-
-skills/ 中的技能会自动注入为 `skills` 数组，每个元素包含 `name` 和 `description`：
-
-```markdown
-{% for skill in skills %}
-- **{{ skill.name }}**：{{ skill.description }}
-{% endfor %}
-```
-
-### tools / tool 变量
-
-所有工具（本地 + MCP）提供两种访问方式：
-
-- `tools` — 数组，用于遍历
-- `tool` — 对象（map），按名字直接访问
-
-```markdown
-{# 数组遍历 #}
-{% for tool in tools %}
-- **{{ tool.name }}**：{{ tool.description }}
-{% endfor %}
-
-{# 按名字访问 #}
-{{ tool.search.description }}
-```
-
-### mcp 变量
-
-mcp.json 中配置的 MCP 服务器和工具，按服务器名称分组访问：
-
-每个服务器也提供 `tools`（数组）和 `tool`（对象）两种形式：
-
-**遍历特定服务器的工具：**
-
-```markdown
-{% for tool in mcp.playwright.tools %}
-- {{ tool.name }}：{{ tool.description }}
-{% endfor %}
-```
-
-**按名字访问特定工具：**
-
-```markdown
-{{ mcp.playwright.tool.playwright__browser_click.description }}
-```
-
-**遍历所有服务器：**
-
-```markdown
-{% for server in mcp.servers %}
-### {{ server.name }}
-{% for tool in server.tools %}
-- {{ tool.name }}：{{ tool.description }}
-{% endfor %}
-{% endfor %}
-```
-
-**访问服务器名称：**
-
-```markdown
-{{ mcp.playwright.name }}
-```
-
-> `mcp.{serverName}` 中的 serverName 对应 mcp.json 里 `mcpServers` 的 key。
-
-## Liquid 模板语法
-
-### 遍历对象数组
-
-```markdown
-{% for item in examples %}
-### 问：{{ item.input }}
-{{ item.output }}
-{% endfor %}
-```
-
-### 条件判断
-
-```markdown
-{% if greeting %}
-{{ greeting }}
-{% endif %}
-```
-
-## 示例
-
-```markdown
-你是一个专业的编程助手。
-
-## 规则
-
-{% for rule in rules %}
-- {{ rule }}
-{% endfor %}
-
-## 可用技能
-
-{% for skill in skills %}
-- **{{ skill.name }}**：{{ skill.description }}
-{% endfor %}
-
-## 可用工具
-
-{% for tool in tools %}
-- **{{ tool.name }}**：{{ tool.description }}
-{% endfor %}
-
-## 浏览器工具
-
-{% for tool in mcp.playwright.tools %}
-- {{ tool.name }}：{{ tool.description }}
-{% endfor %}
-
-## 示例
-
-{% for item in examples %}
-### 问：{{ item.input }}
-
-{{ item.output }}
-
-{% endfor %}
-```
-
-## 写作建议
-
-1. 开头明确 agent 的角色定位
-2. 用 Markdown 标题组织结构（# 角色、## 规则、## 技能、## 示例）
-3. 规则用列表形式，简洁明了
-4. few-shot 示例放在 datasets/ 中通过模板引用，保持文件整洁
-5. 避免在提示词中硬编码大量数据，用 datasets 管理
-6. 用 `skills` 变量列出可用技能，让 agent 知道自己能做什么
-7. 用 `tools` 变量列出所有工具，用 `mcp.{serverName}.tools` 按服务器分类展示 MCP 工具
-
-## 注意
-
-- 不要使用 YAML frontmatter（system-prompt.md 不需要）
-- Liquid 标签必须正确闭合（`{% for %}...{% endfor %}`、`{% if %}...{% endif %}`）
-- datasets 模板变量名必须和 datasets/ 中的文件名一致
-- `skills`、`tools`、`tool`、`mcp` 是内置变量名，不要在 datasets/ 中创建同名文件
-
-请根据用户需求创建或修改系统提示词。$ARGUMENTS

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

@@ -1,56 +0,0 @@
----
-name: create-tool
-description: 创建工具定义 JSON 文件。当用户需要新增一个 tool、定义工具 schema 时使用。
-argument-hint: "[tool_name]"
----
-
-在 `agents/my-agent/tools/` 目录下创建一个新的工具定义 JSON 文件。
-
-## 规范
-
-- 文件名与工具 `name` 一致，如 `send_email.json`
-- 必须通过 `src/schemas/tool.schema.json` 的校验
-
-## 必填字段
-
-- `name`：工具名称，匹配 `^[a-z][a-z0-9_]*$`
-- `description`：工具用途描述，要让模型理解何时调用
-- `input_schema`：入参定义，JSON Schema object 子集
-
-## input_schema 规范
-
-- `type` 必须为 `"object"`
-- `properties` 中每个参数必须有 `type`（string / number / boolean / array / object）
-- 建议每个参数写 `description`
-- 可选：`enum`、`items`（array 子项）、`required`（必填参数列表）
-
-## 示例
-
-```json
-{
-  "name": "web_search",
-  "description": "Search the web and return relevant results for a given query",
-  "input_schema": {
-    "type": "object",
-    "properties": {
-      "query": {
-        "type": "string",
-        "description": "The search query"
-      },
-      "limit": {
-        "type": "number",
-        "description": "Maximum number of results to return"
-      }
-    },
-    "required": ["query"]
-  }
-}
-```
-
-## 注意
-
-- 一个文件只定义一个工具
-- `required` 只列真正必须的参数
-- 不要添加 `name`、`description`、`input_schema` 以外的字段
-
-请根据用户的需求创建工具定义文件。$ARGUMENTS

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

@@ -1,83 +0,0 @@
----
-name: create-tool-impl
-description: 创建工具实现文件。当用户需要为 tool 编写具体的实现代码时使用。
-argument-hint: "[tool_name]"
----
-
-在 `agents/my-agent/tool-impls/` 目录下创建工具实现文件。
-
-## 规范
-
-- 文件名格式：`<tool-name>.impl.js`，与 `tools/<tool-name>.json` 一一对应
-- ES6 模块语法，`export default async function`
-- 函数接收参数对象，参数与对应 tool JSON 的 `input_schema.properties` 一致
-- 返回 Promise<object>
-
-## 文件结构
-
-```
-tool-impls/
-└── <tool-name>.impl.js    ← 与 tools/<tool-name>.json 对应
-```
-
-## 模板
-
-```javascript
-/**
- * <Tool description>
- * @param {object} params
- * @param {<type>} params.<param_name> - <param description>
- * @returns {Promise<object>} <return description>
- */
-export default async ({ param1, param2 }) => {
-  // 实现逻辑
-  return { result: "..." };
-};
-```
-
-## 示例
-
-### 搜索工具（对应 tools/search.json）
-
-```javascript
-/**
- * Search tool implementation
- * @param {object} params
- * @param {string} params.query - Search query
- * @returns {Promise<object>} Search results
- */
-export default async ({ query }) => {
-  // TODO: integrate with real search API
-  return {
-    results: [
-      { title: `Result for: ${query}`, url: "https://example.com" },
-    ],
-  };
-};
-```
-
-### 计算器（对应 tools/calculator.json）
-
-```javascript
-/**
- * Calculator tool implementation
- * @param {object} params
- * @param {string} params.expression - Mathematical expression
- * @returns {Promise<object>} Calculation result
- */
-export default async ({ expression }) => {
-  const result = Function(`"use strict"; return (${expression})`)();
-  return { expression, result };
-};
-```
-
-## 注意
-
-- 文件名必须是 `<tool-name>.impl.js`，其中 `<tool-name>` 与 tools/ 中的 JSON 文件名一致
-- 函数参数通过解构获取，参数名与 tool JSON 中 `input_schema.properties` 的 key 一致
-- 必须使用 `export default`，不能用 `module.exports`
-- 函数必须是 async 的，返回对象
-- 用 JSDoc 注释描述参数和返回值
-- 每个 tool 必须有且仅有一个对应的 impl 文件
-
-请根据用户的需求创建工具实现文件。$ARGUMENTS

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

@@ -1,117 +0,0 @@
----
-name: create-tool-test
-description: 创建工具测试文件。当用户需要为 tool-impl 编写测试用例时使用。
-argument-hint: "[tool_name]"
----
-
-在 `agents/my-agent/tests/` 目录下创建工具测试文件。
-
-## 规范
-
-- 文件名格式：`<tool-name>.test.js`，与 `tool-impls/<tool-name>.impl.js` 一一对应
-- ES6 模块语法，`export default` 导出测试用例数组
-- 每个测试用例是一个对象，包含 `name`、`args`，以及可选的 `expected` 或 `validate`
-- 通过 `archon-claw test <agent-dir>` 命令运行
-
-## 文件结构
-
-```
-agents/<agent-name>/
-├── tool-impls/
-│   └── <tool-name>.impl.js     ← 工具实现
-└── tests/
-    └── <tool-name>.test.js      ← 对应的测试文件
-```
-
-## 测试用例字段
-
-| 字段 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `name` | string | 是 | 测试名称，描述测试内容 |
-| `args` | object | 是 | 传给 impl 函数的参数 |
-| `expected` | any | 否 | 期望返回值，深度比较 |
-| `validate` | function | 否 | 自定义校验函数 |
-
-### 三种断言方式
-
-1. **`expected`** — 精确匹配返回值（深度比较）
-2. **`validate(result)`** — 自定义校验，返回 `true` 表示通过，返回字符串表示失败原因
-3. **都不写** — 只验证调用不抛异常
-
-## 模板
-
-```javascript
-export default [
-  {
-    name: "描述测试内容",
-    args: { param1: "value1" },
-    expected: { result: "expected_value" },
-  },
-  {
-    name: "自定义校验",
-    args: { param1: "value1" },
-    validate: (result) =>
-      result.field === "expected" || `expected "expected", got "${result.field}"`,
-  },
-  {
-    name: "只要不抛异常就通过",
-    args: { param1: "value1" },
-  },
-];
-```
-
-## 示例
-
-### 计算器测试（对应 tool-impls/calculator.impl.js）
-
-```javascript
-export default [
-  {
-    name: "addition: 1 + 2 = 3",
-    args: { expression: "1 + 2" },
-    expected: { expression: "1 + 2", result: 3 },
-  },
-  {
-    name: "complex expression",
-    args: { expression: "(10 + 5) * 2 - 4" },
-    validate: (result) => result.result === 26 || `expected 26, got ${result.result}`,
-  },
-];
-```
-
-### 搜索测试（对应 tool-impls/search.impl.js）
-
-```javascript
-export default [
-  {
-    name: "returns results array",
-    args: { query: "hello" },
-    validate: (result) =>
-      Array.isArray(result.results) || "expected results to be an array",
-  },
-  {
-    name: "result contains query in title",
-    args: { query: "test query" },
-    validate: (result) =>
-      result.results[0]?.title.includes("test query") ||
-      `expected title to contain "test query"`,
-  },
-];
-```
-
-## 运行测试
-
-```bash
-archon-claw test agents/my-agent
-```
-
-## 注意
-
-- 测试文件放在 `tests/` 目录，与 `tool-impls/` 同级
-- 文件名必须是 `<tool-name>.test.js`，其中 `<tool-name>` 与 `tool-impls/` 中的 `.impl.js` 文件名一致
-- 必须使用 `export default`，导出数组
-- 每个用例必须有 `name` 和 `args`
-- `validate` 函数返回 `true` 或错误消息字符串
-- `expected` 和 `validate` 二选一，都不写则只检查不抛异常
-
-请根据用户的需求创建工具测试文件。$ARGUMENTS

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

@@ -1,218 +0,0 @@
----
-name: create-tool-ui
-description: 创建工具自定义 UI 组件。当用户需要为工具定制 Chat UI 中的展示效果时使用。
-argument-hint: "[tool_name]"
----
-
-在 `agents/<agent>/tool-uis/` 目录下创建工具自定义 UI 文件。
-
-## 背景
-
-默认情况下，所有工具在 Chat UI 中以可折叠的 JSON 面板展示（args + result）。通过自定义 UI，可以用 Web Component 替代默认展示，提供更直观的交互体验。
-
-## 规范
-
-- 文件名格式：`<tool-name>.ui.js`，必须与 `tools/<tool-name>.json` 的 name 一致
-- 文件内定义一个 **Custom Element**（Web Component），使用 Shadow DOM 隔离样式
-- Custom Element 标签名必须是 `tool-ui-<tool-name>`
-- 数据通过 **JS property**（不是 HTML attribute）传入：
-  - `args`：`Record<string, unknown>` — 工具调用参数
-  - `result`：`unknown` — 工具返回结果（运行中时为 `undefined`）
-  - `status`：`"running"` | `"done"` — 执行状态
-- 每次 property 被赋值时应触发重新渲染
-
-## 文件结构
-
-```
-agents/<agent>/
-├── tools/search.json
-├── tool-impls/search.impl.js
-└── tool-uis/search.ui.js        ← 新增：自定义 UI
-```
-
-## 模板
-
-```javascript
-class <ToolName>UI extends HTMLElement {
-  constructor() {
-    super();
-    this.attachShadow({ mode: 'open' });
-    this._args = {};
-    this._result = undefined;
-    this._status = 'running';
-  }
-
-  set args(v) { this._args = v; this.render(); }
-  set result(v) { this._result = v; this.render(); }
-  set status(v) { this._status = v; this.render(); }
-  get args() { return this._args; }
-  get result() { return this._result; }
-  get status() { return this._status; }
-
-  connectedCallback() { this.render(); }
-
-  render() {
-    const isRunning = this._status === 'running';
-    this.shadowRoot.innerHTML = `
-      <style>
-        :host { display: block; border: 1px solid #e5e7eb; border-radius: 8px; overflow: hidden; font-family: system-ui, sans-serif; font-size: 14px; }
-        .header { display: flex; align-items: center; gap: 8px; padding: 8px 12px; background: #f9fafb; border-bottom: 1px solid #e5e7eb; }
-        .name { font-weight: 500; color: #374151; }
-        .status { color: #9ca3af; font-size: 12px; }
-        .body { padding: 8px 12px; }
-      </style>
-      <div class="header">
-        <span class="name"><tool-name></span>
-        <span class="status">${isRunning ? 'Running...' : 'Done'}</span>
-      </div>
-      <div class="body">
-        ${isRunning ? '<span class="status">Processing...</span>' : this.renderResult()}
-      </div>
-    `;
-  }
-
-  renderResult() {
-    // 根据 this._result 的结构自定义渲染
-    return `<pre style="margin:0;white-space:pre-wrap;font-size:12px;">${this.escapeHtml(JSON.stringify(this._result, null, 2))}</pre>`;
-  }
-
-  escapeHtml(str) {
-    const d = document.createElement('div');
-    d.textContent = String(str);
-    return d.innerHTML;
-  }
-}
-
-customElements.define('tool-ui-<tool-name>', <ToolName>UI);
-```
-
-## 示例
-
-### 搜索工具（对应 tools/search.json）
-
-```javascript
-class SearchUI extends HTMLElement {
-  constructor() {
-    super();
-    this.attachShadow({ mode: 'open' });
-    this._args = {};
-    this._result = undefined;
-    this._status = 'running';
-  }
-
-  set args(v) { this._args = v; this.render(); }
-  set result(v) { this._result = v; this.render(); }
-  set status(v) { this._status = v; this.render(); }
-  get args() { return this._args; }
-  get result() { return this._result; }
-  get status() { return this._status; }
-
-  connectedCallback() { this.render(); }
-
-  render() {
-    const query = this._args?.query || '';
-    const isRunning = this._status === 'running';
-    this.shadowRoot.innerHTML = `
-      <style>
-        :host { display: block; border: 1px solid #e5e7eb; border-radius: 8px; overflow: hidden; font-family: system-ui, sans-serif; font-size: 14px; }
-        .header { display: flex; align-items: center; gap: 8px; padding: 8px 12px; background: #fefce8; border-bottom: 1px solid #e5e7eb; }
-        .query { font-weight: 500; color: #92400e; }
-        .body { padding: 8px 12px; }
-        .item { padding: 6px 0; border-bottom: 1px solid #f3f4f6; }
-        .item:last-child { border-bottom: none; }
-        .title { color: #1d4ed8; font-weight: 500; }
-        .url { color: #16a34a; font-size: 11px; margin-top: 1px; }
-        .status { color: #9ca3af; font-size: 12px; }
-      </style>
-      <div class="header">
-        <span>🔍</span>
-        <span class="query">${this.esc(query)}</span>
-        <span class="status">${isRunning ? '⏳' : 'Done'}</span>
-      </div>
-      ${isRunning
-        ? '<div class="body"><span class="status">Searching...</span></div>'
-        : (this._result ? this.renderResult() : '')}
-    `;
-  }
-
-  renderResult() {
-    const r = this._result;
-    const items = Array.isArray(r) ? r : (r && Array.isArray(r.results)) ? r.results : null;
-    if (items) {
-      return `<div class="body">${items.slice(0, 5).map(i => `
-        <div class="item">
-          <div class="title">${this.esc(i.title || '')}</div>
-          ${i.url ? `<div class="url">${this.esc(i.url)}</div>` : ''}
-        </div>`).join('')}</div>`;
-    }
-    return `<div class="body"><pre style="margin:0;white-space:pre-wrap;font-size:12px;">${this.esc(JSON.stringify(r, null, 2))}</pre></div>`;
-  }
-
-  esc(s) { const d = document.createElement('div'); d.textContent = String(s); return d.innerHTML; }
-}
-
-customElements.define('tool-ui-search', SearchUI);
-```
-
-### 计算器（对应 tools/calculator.json）
-
-```javascript
-class CalculatorUI extends HTMLElement {
-  constructor() {
-    super();
-    this.attachShadow({ mode: 'open' });
-    this._args = {};
-    this._result = undefined;
-    this._status = 'running';
-  }
-
-  set args(v) { this._args = v; this.render(); }
-  set result(v) { this._result = v; this.render(); }
-  set status(v) { this._status = v; this.render(); }
-  get args() { return this._args; }
-  get result() { return this._result; }
-  get status() { return this._status; }
-
-  connectedCallback() { this.render(); }
-
-  render() {
-    const expr = this._args?.expression || '';
-    const isRunning = this._status === 'running';
-    const result = this._result;
-    this.shadowRoot.innerHTML = `
-      <style>
-        :host { display: block; border: 1px solid #e5e7eb; border-radius: 8px; overflow: hidden; font-family: system-ui, sans-serif; font-size: 14px; }
-        .calc { padding: 10px 14px; background: #f0fdf4; display: flex; align-items: center; gap: 8px; }
-        .expr { font-family: monospace; color: #374151; }
-        .eq { color: #9ca3af; }
-        .val { font-family: monospace; font-weight: 600; color: #15803d; }
-        .status { color: #9ca3af; font-size: 12px; }
-      </style>
-      <div class="calc">
-        <span>🧮</span>
-        <span class="expr">${this.esc(expr)}</span>
-        ${isRunning
-          ? '<span class="status">Computing...</span>'
-          : `<span class="eq">=</span> <span class="val">${this.esc(result?.result ?? '')}</span>`}
-      </div>
-    `;
-  }
-
-  esc(s) { const d = document.createElement('div'); d.textContent = String(s); return d.innerHTML; }
-}
-
-customElements.define('tool-ui-calculator', CalculatorUI);
-```
-
-## 注意
-
-- 文件名必须是 `<tool-name>.ui.js`，且 `tools/<tool-name>.json` 必须存在，否则不会被加载
-- Custom Element 标签名必须是 `tool-ui-<tool-name>`，使用 `customElements.define()` 注册
-- 必须使用 `this.attachShadow({ mode: 'open' })` 创建 Shadow DOM，确保样式隔离
-- 数据通过 JS property setter 传入（不是 attribute），每个 setter 内应调用 `this.render()`
-- `result` 的类型取决于 tool-impl 的返回值，编写 `renderResult()` 时应处理多种可能的数据结构
-- 组件运行在浏览器环境，可以使用所有 Web API（DOM、fetch 等）
-- 不要依赖外部 CDN 资源，所有样式应内联在 Shadow DOM 的 `<style>` 中
-- 使用 `escapeHtml` 防止 XSS — 永远不要直接拼接用户输入到 innerHTML
-
-请根据用户的需求创建工具 UI 组件文件。$ARGUMENTS

package/dist/templates/workspace/README.md

@@ -1,13 +0,0 @@
-# {{name}}
-
-Built with [archon-claw](https://github.com/anthropics/archon-claw).
-
-## Getting Started
-
-```bash
-# Start dev server
-npm run dev
-
-# Start production server
-npm run start
-```

package/dist/templates/workspace/package.json

@@ -1,19 +0,0 @@
-{
-  "name": "{{name}}",
-  "version": "1.0.0",
-  "description": "",
-  "type": "module",
-  "scripts": {
-    "dev": "archon-claw dev --agents-dir agents",
-    "start": "archon-claw start --agents-dir agents -p ${PORT:-5100}",
-    "test": "archon-claw test agents/my-agent",
-    "eval": "archon-claw eval agents/my-agent",
-    "create:agent": "archon-claw create-agent",
-    "export:skills": "archon-claw export-skills .claude/skills"
-  },
-  "keywords": [],
-  "license": "ISC",
-  "dependencies": {
-    "@archon-claw/cli": "^{{cliVersion}}"
-  }
-}