feat: 统一全局技能至 v2.1.0，简化 API 调用方式

- 4 个全局技能版本统一为 2.1.0 - 移除 fetch_api 工具引用，改为通过 Bash/curl 调用 HTTP API - API 基础地址由 system prompt 注入，技能无需自行端口发现 - create-agent 改为以用户阅读体验优先的 blockquote 格式呈现 markdown 内容
2026-02-28 12:18:07 +08:00 · 2026-02-26 20:38:35 +08:00
parent c1ca91c80a
commit 761226d567
4 changed files with 101 additions and 79 deletions
--- a/skills/create-agent/SKILL.md
+++ b/skills/create-agent/SKILL.md
@@ -1,7 +1,7 @@
 ---
 name: create-agent
 description: 通过多轮对话收集需求，调用 HTTP API 创建新的 AgentFS v2 智能体，支持自定义 persona 和 principles。Use when 用户要求创建新智能体、培养某领域助手、或快速基于模板生成可治理 Agent。
-version: "2.0.0"
+version: "2.1.0"
 type: meta
 risk_level: medium
 status: enabled
@@ -9,8 +9,8 @@ disable-model-invocation: true
 tags: [agent, creation, meta]
 metadata:
  author: desirecore
-  version: "2.0.0"
-  updated_at: "2026-02-21"
+  version: "2.1.0"
+  updated_at: "2026-02-26"
 ---

 # create-agent 技能
@@ -91,40 +91,40 @@ create-agent 是一个**元技能（Meta-Skill）**，赋予 DesireCore 创建

 **persona.md 生成规范**：

-```markdown
-# L0 — 核心身份
+生成 persona.md 时，直接输出以下结构的 markdown 内容供用户阅读和确认，不要用代码块包裹：

-你是 {name}，{一句话角色定位}。
-
-# L1 — 行为风格
-
- {风格特征 1}
- {风格特征 2}
- {风格特征 3}
-
-# L2 — 深层动机
-
-{2-3 句话描述深层价值观和驱动力}
-```
+> **L0 — 核心身份**
+>
+> 你是 {name}，{一句话角色定位}。
+>
+> **L1 — 行为风格**
+>
+> - {风格特征 1}
+> - {风格特征 2}
+> - {风格特征 3}
+>
+> **L2 — 深层动机**
+>
+> {2-3 句话描述深层价值观和驱动力}

 **principles.md 生成规范**：

-```markdown
-# L0 — 基础约束
+生成 principles.md 时，同样直接输出 markdown 内容：

- {安全红线 1}
- {安全红线 2}
-
-# L1 — 行为边界
-
- {行为规则 1}
- {行为规则 2}
- {行为规则 3}
-
-# L2 — 治理原则
-
-{2-3 句话描述最高治理原则}
-```
+> **L0 — 基础约束**
+>
+> - {安全红线 1}
+> - {安全红线 2}
+>
+> **L1 — 行为边界**
+>
+> - {行为规则 1}
+> - {行为规则 2}
+> - {行为规则 3}
+>
+> **L2 — 治理原则**
+>
+> {2-3 句话描述最高治理原则}

 **领域匹配参考**：

@@ -139,26 +139,34 @@ create-agent 是一个**元技能（Meta-Skill）**，赋予 DesireCore 创建

 **展示预览**：

-```
-即将创建智能体：
+向用户展示预览时，以自然可读的 markdown 格式直接呈现，不使用代码块包裹：

-名称：法律顾问小助手
-描述：专注于合同审查和法律风险评估的数字智能体
-
--- persona.md 预览 ---
-# L0 — 核心身份
-你是法律顾问小助手，专注于合同审查和法律风险评估...
-[完整内容]
-
--- principles.md 预览 ---
-# L0 — 基础约束
- 不提供诉讼代理
-[完整内容]
---
-
-确认创建？
-[确认] [修改] [取消]
-```
+> 即将创建智能体：
+>
+> **名称**：法律顾问小助手
+> **描述**：专注于合同审查和法律风险评估的数字智能体
+>
+> ---
+>
+> **persona.md 预览**
+>
+> **L0 — 核心身份**
+> 你是法律顾问小助手，专注于合同审查和法律风险评估...
+>
+> *(完整内容)*
+>
+> ---
+>
+> **principles.md 预览**
+>
+> **L0 — 基础约束**
+> - 不提供诉讼代理
+>
+> *(完整内容)*
+>
+> ---
+>
+> 确认创建？（确认 / 修改 / 取消）

 ### 阶段 5：调用 API 创建

@@ -191,19 +199,19 @@ create-agent 是一个**元技能（Meta-Skill）**，赋予 DesireCore 创建

 **回执报告**：

-```
-✅ 智能体 "法律顾问小助手" 创建成功
+创建成功后，以自然可读格式呈现回执：

-详情：
- Agent Slug: fa-lv-gu-wen-xiao-zhu-shou
- 仓库路径: ~/.desirecore/agents/fa-lv-gu-wen-xiao-zhu-shou
- 已生成文件: agent.json, persona.md, principles.md
- AgentFS 规范: v2（扁平结构）
-
-下一步建议：
- 为它添加技能（通过 update-agent 技能）
- 直接开始对话
-```
+> 智能体 "法律顾问小助手" 创建成功
+>
+> **详情**：
+> - **Agent Slug**: fa-lv-gu-wen-xiao-zhu-shou
+> - **仓库路径**: ~/.desirecore/agents/fa-lv-gu-wen-xiao-zhu-shou
+> - **已生成文件**: agent.json, persona.md, principles.md
+> - **AgentFS 规范**: v2（扁平结构）
+>
+> **下一步建议**：
+> - 为它添加技能（通过 update-agent 技能）
+> - 直接开始对话

 ### AgentFS 知识（创建后的仓库结构）

@@ -245,9 +253,11 @@ DesireCore 应理解创建后的 Agent 仓库遵循 AgentFS v2 扁平结构：

 ### 权限要求

- 需要调用 `fetch_api` 工具访问创建 API
+- 建议优先通过 `Bash` 工具调用 curl 访问 Agent Service HTTP API 完成操作
+- API 基础地址已注入到 system prompt 的「本机 API」小节，直接引用即可
 - 创建操作需要用户确认

 ### 依赖

 - Agent Service HTTP API（`POST /api/agents`）
+- System prompt 中的本机 API 地址声明
--- a/skills/delete-agent/SKILL.md
+++ b/skills/delete-agent/SKILL.md
@@ -7,8 +7,8 @@ status: enabled
 disable-model-invocation: true
 metadata:
  author: desirecore
-  version: "1.0.0"
-  updated_at: "2026-02-17"
+  version: "2.1.0"
+  updated_at: "2026-02-26"
 ---

 # delete-agent 技能
@@ -123,9 +123,11 @@ delete-agent 是一个**元技能（Meta-Skill）**，赋予 DesireCore 安全

 **请求示例**：
 ```bash
-curl -X DELETE "http://127.0.0.1:<agentServicePort>/api/agents/legal-assistant?deleteRuns=true"
+curl -X DELETE "{agentServiceUrl}/api/agents/legal-assistant?deleteRuns=true"
 ```

+> `{agentServiceUrl}` 取自 system prompt「本机 API」小节中的 Agent Service 地址。
+
 ### 阶段 6：返回操作结果

 **成功响应处理**：
@@ -165,7 +167,7 @@ curl -X DELETE "http://127.0.0.1:<agentServicePort>/api/agents/legal-assistant?d
 在调用删除 API 前，系统会自动检查：

 | 状态 | 是否可删除 | 处理方式 |
-|------|-----------|---------|
+|------|-----------|--------|
 | `offline` | ✅ 是 | 直接删除 |
 | `error` | ✅ 是 | 直接删除 |
 | `online` | ❌ 否 | 返回 409 错误，提示先停止 |
@@ -234,10 +236,11 @@ curl -X DELETE "http://127.0.0.1:<agentServicePort>/api/agents/legal-assistant?d

 ## 权限要求

- 需要调用 `fetch_api` 工具访问删除 API
+- 建议优先通过 `Bash` 工具调用 curl 访问 Agent Service HTTP API 完成操作
+- API 基础地址已注入到 system prompt 的「本机 API」小节，直接引用即可
 - 删除操作需要用户显式确认（高风险操作）

 ## 依赖

- Agent Service HTTP API
- Agent Registry 状态查询
+- Agent Service HTTP API（`DELETE /api/agents/{agentId}`）
+- System prompt 中的本机 API 地址声明
--- a/skills/discover-agent/SKILL.md
+++ b/skills/discover-agent/SKILL.md
@@ -1,7 +1,7 @@
 ---
 name: discover-agent
 description: 根据用户需求推荐最匹配的智能体，展示候选列表并引导选择。Use when 用户描述需求但不确定该找哪个智能体帮忙，或想浏览可用的智能体。
-version: "1.0.0"
+version: "2.1.0"
 type: procedural
 risk_level: low
 status: enabled
@@ -9,8 +9,8 @@ disable-model-invocation: false
 tags: [agent, discovery, recommendation]
 metadata:
  author: desirecore
-  version: "1.0.0"
-  updated_at: "2026-02-17"
+  version: "2.1.0"
+  updated_at: "2026-02-26"
 ---

 # discover-agent 技能
@@ -218,10 +218,11 @@ context_handoff:

 ### 权限要求

- 需要调用 `fetch_api` 工具访问 Agent 列表 API
+- 建议优先通过 `Bash` 工具调用 curl 访问 Agent Service HTTP API 完成操作
+- API 基础地址已注入到 system prompt 的「本机 API」小节，直接引用即可
 - 只读操作，无风险

 ### 依赖

 - Agent Service HTTP API（`GET /api/agents`）
- Agent Registry 状态查询
+- System prompt 中的本机 API 地址声明
--- a/skills/update-agent/SKILL.md
+++ b/skills/update-agent/SKILL.md
@@ -1,7 +1,7 @@
 ---
 name: update-agent
 description: 安全更新现有智能体的配置、人格、原则、技能与记忆，输出可审阅 diff 并在确认后应用与提交。Use when 用户要求修改 Agent 行为、安装/卸载技能、调整配置、回滚变更或修订规则。
-version: "1.1.0"
+version: "2.1.0"
 type: meta
 risk_level: high
 status: enabled
@@ -9,8 +9,8 @@ disable-model-invocation: true
 tags: [agent, update, meta]
 metadata:
  author: desirecore
-  version: "1.1.0"
-  updated_at: "2026-02-17"
+  version: "2.1.0"
+  updated_at: "2026-02-26"
 ---

 # update-agent 技能
@@ -266,6 +266,14 @@ git reset --soft <commit_hash>
 | Git 操作失败 | 保留修改文件，提示用户手动提交 |
 | 回滚版本不存在 | 列出可用版本，请用户重新选择 |

+### API 端点
+
+建议优先通过 HTTP API 完成操作，也可直接通过 Read/Write/Edit 工具编辑 AgentFS 文件：
+
+- `PUT /api/agents/:id/files/*` — 更新指定文件内容
+
+API 基础地址已注入到 system prompt 的「本机 API」小节，使用 `Bash` 工具调用 curl 访问即可。
+
 ### 权限要求

 | 操作 | 所需角色 |