From 74be106952b4aad5050ef8db1f9be4f99cea1203 Mon Sep 17 00:00:00 2001 From: Yige Date: Sun, 19 Jul 2026 16:14:22 +0800 Subject: [PATCH] =?UTF-8?q?fix(skills):=20=E8=A1=A5=E5=9B=9E=20#56=20?= =?UTF-8?q?=E5=8E=8B=E7=BC=A9=E6=97=B6=E8=AF=AF=E5=88=A0=E7=9A=84=E5=AE=9E?= =?UTF-8?q?=E8=B4=A8=E4=BF=A1=E6=81=AF=EF=BC=88=E6=84=8F=E5=9B=BE=E5=AF=B9?= =?UTF-8?q?=E9=BD=90=EF=BC=89=20(#57)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ## 摘要 / Summary ### 中文 #56 的复盘修正。上一轮"强改写压缩"把四技能 L1 的**技术属性、使用场景与交互示范当套话一刀切**，造成实质信息丢失（承诺"意图全保留"但未做到）。本 PR 补回： - **create**：`创建仓库符合 AgentFS v2 规范、git 管理版本（可治理/可追溯）`定位；`基础创建`形态（name+description，description 自动填充 persona L0）；需求收集的**引导问题示例**（"起什么名字？/主要负责什么？"…）；企业部署/开发者原型使用场景。 - **update**：`agent 目录 git 管理版本、历史可追溯`定位 + 使用场景。 - **discover**：使用场景（浏览/新用户/找替代）+ `语义匹配而非关键词搜索`。 - **delete**：使用场景（清理/测试/释放存储）。 根因：L1 混着实质技术属性与营销套话、使用场景是触发判据、引导问题是交互示范，不该按"只留独有信息"一刀切。补回后仍保留结构性压缩（zh 正文合计仍降 ~64%）。版本 create 2.5.2 / update 3.1.3 / delete 2.5.2 / discover 2.6.2，manifest 1.2.13，中英双份同步、重算 source_hash（validate-i18n 通过）。 ### English Post-mortem fix for #56. The previous aggressive compression treated the skills' L1 technical attributes, use cases, and interaction demos as boilerplate and cut them in a blanket way, dropping substantive information (the "all intent preserved" claim wasn't fully met). This PR restores: create's AgentFS-v2 / git-version-management positioning, the "basic create" form (name+description auto-filling persona L0), the requirement-gathering prompt questions, and enterprise/developer use cases; update's git-versioned/traceable positioning and use cases; discover's use cases and "semantic match, not keyword search"; delete's use cases. Root cause: L1 mixed real technical attributes with marketing boilerplate, use cases are trigger cues, and prompt questions are interaction demos — none should have been blanket-cut. Structural compression is retained (zh bodies still ~64% smaller). Versions bumped, manifest 1.2.13, both locales synced, source hashes recomputed (validate-i18n passes). --- manifest.json | 2 +- skills/create-agent/CHANGELOG.md | 4 ++++ skills/create-agent/SKILL.md | 11 ++++++----- skills/create-agent/SKILL.zh-CN.md | 5 +++-- skills/delete-agent/CHANGELOG.md | 4 ++++ skills/delete-agent/SKILL.md | 8 ++++---- skills/delete-agent/SKILL.zh-CN.md | 2 +- skills/discover-agent/CHANGELOG.md | 4 ++++ skills/discover-agent/SKILL.md | 8 ++++---- skills/discover-agent/SKILL.zh-CN.md | 2 +- skills/update-agent/CHANGELOG.md | 4 ++++ skills/update-agent/SKILL.md | 8 ++++---- skills/update-agent/SKILL.zh-CN.md | 2 +- 13 files changed, 41 insertions(+), 23 deletions(-) diff --git a/manifest.json b/manifest.json index 4ebef81..5c5f760 100644 --- a/manifest.json +++ b/manifest.json @@ -1,6 +1,6 @@ { "name": "DesireCore Official Market", - "version": "1.2.12", + "version": "1.2.13", "schemaVersion": "1.1.0", "supportedLocales": ["zh-CN", "en-US"], "defaultLocale": "en-US", diff --git a/skills/create-agent/CHANGELOG.md b/skills/create-agent/CHANGELOG.md index 9ab0eb2..813c533 100644 --- a/skills/create-agent/CHANGELOG.md +++ b/skills/create-agent/CHANGELOG.md @@ -1,5 +1,9 @@ # Changelog +## [2.5.2] - 2026-07-19 + +- 复盘补回改写压缩时误删的实质信息：create 的 AgentFS v2/git 版本管理定位、基础创建（name+description 自动填充 persona L0）、需求收集引导问题示例；update/delete/discover 的使用场景与版本管理定位。功能对齐原始意图，仍保留结构性压缩。 + ## [2.5.1] - 2026-07-19 - 提示词改写压缩，功能不变——与 ManageAgent 工具契约重复的说明、装饰框图、重复表改写融入流程，示例就地精简；不外置、不净删，意图全保留。 diff --git a/skills/create-agent/SKILL.md b/skills/create-agent/SKILL.md index fee7c9f..1087656 100644 --- a/skills/create-agent/SKILL.md +++ b/skills/create-agent/SKILL.md @@ -2,7 +2,7 @@ name: create-agent description: >- 通过多轮对话收集需求，调用 ManageAgent 内置工具创建新的 AgentFS v2 智能体，支持自定义 persona 和 principles。Use when 用户要求创建新智能体、培养某领域助手、或快速基于模板生成可治理 Agent。 -version: 2.5.1 +version: 2.5.2 type: meta risk_level: low status: enabled @@ -26,7 +26,7 @@ metadata: description: >- 通过多轮对话收集需求，调用 ManageAgent 内置工具创建新的 AgentFS v2 智能体，支持自定义 persona 和 principles。Use when 用户要求创建新智能体、培养某领域助手、或快速基于模板生成可治理 Agent。 body: ./SKILL.zh-CN.md - source_hash: sha256:a119427bed3bcd72 + source_hash: sha256:fa447cd4d5a5b336 translated_by: human en-US: name: Create Agent @@ -34,7 +34,7 @@ metadata: description: >- Collect requirements through multi-turn conversation and call the ManageAgent builtin tool to create a new AgentFS v2 Agent, with customizable persona and principles. Use when the user asks to create a new Agent, raise a domain assistant, or quickly produce a governable Agent from a template. body: ./SKILL.md - source_hash: sha256:a119427bed3bcd72 + source_hash: sha256:fa447cd4d5a5b336 translated_by: ai:claude-fable-5 translated_at: '2026-07-19' market: @@ -68,7 +68,7 @@ Collect requirements through natural-language conversation and call the ManageAg ## L1: Overview -Meta-skill: gather requirements over multi-turn conversation → generate persona/principles → land via `ManageAgent(action='create')`. Use it to raise a domain specialist for the user (legal advisor, financial analyst, etc.). Its value is what the tool can't give: domain-tailored persona/principles generation + a pre-create preview confirmation. +Meta-skill: gather requirements over multi-turn conversation → generate persona/principles → land via `ManageAgent(action='create')`. Use it to raise a domain specialist (legal advisor, financial analyst), deploy a customized business Agent quickly, or produce a prototype from a template. The created repo conforms to the AgentFS v2 spec and is version-managed by git (governable, traceable). Its value is what the tool can't give: domain-tailored persona/principles generation + a pre-create preview confirmation. ## L2: Detailed Spec @@ -80,7 +80,7 @@ Trigger (any): user explicitly says "create an Agent / make me an assistant"; de ### Stage 2: Requirement Gathering -- Required: `name`, `role` (core responsibility), `target_users`, `domain` (specialty). +- Required (parenthesized = example prompt question): `name` ("what to name it?"), `role` ("what does it mainly do?"), `target_users` ("who will use it?"), `domain` ("what expertise does it need?"). - Optional: `style` (communication tone), `boundaries` (red lines), `language` (default Chinese) — defaults derived from the domain template. - Strategy: prefer inferring from the user's natural description; only ask for missing required fields; at most 2 questions per turn. @@ -126,6 +126,7 @@ ManageAgent({ ``` - Minimal create needs only `{ "action": "create", "name": "My Assistant" }` (everything else auto-generated). +- Basic create `{ "action": "create", "name": "Legal Advisor", "description": "contract review" }` — with just name + description, the description auto-fills persona's L0. - Optional `id` (kebab-case slug; `core` / `desirecore` are reserved core identifiers and cannot be used, including when the slug auto-generated from `name` collides), `config.llm` (llm delta only; sensitive fields like mcp_servers are rejected and must be adjusted via the UI after creation). - The Agent is registered and usable immediately; the returned ID works directly with ManageTeam / Delegate. If the tool errors (already exists / reserved identifier / non-whitelisted config field, etc.), explain the reason and retry after adjusting per the hint. diff --git a/skills/create-agent/SKILL.zh-CN.md b/skills/create-agent/SKILL.zh-CN.md index 792946d..71ea832 100644 --- a/skills/create-agent/SKILL.zh-CN.md +++ b/skills/create-agent/SKILL.zh-CN.md @@ -8,7 +8,7 @@ ## L1：概述 -元技能：多轮对话收集需求 → 生成 persona/principles → `ManageAgent(action='create')` 落地。用于为用户培养某专业领域的数字助手（法律顾问、财务分析师等）。价值在工具给不了的部分：领域化的人格/原则生成 + 创建前的预览确认。 +元技能：多轮对话收集需求 → 生成 persona/principles → `ManageAgent(action='create')` 落地。用于为用户培养专业领域数字助手（法律顾问、财务分析师）、企业快速部署定制业务 Agent、或基于模板快速创建原型。创建的仓库符合 AgentFS v2 规范、由 git 管理版本（可治理、可追溯）。价值在工具给不了的部分：领域化的人格/原则生成 + 创建前的预览确认。 ## L2：详细规范 @@ -20,7 +20,7 @@ ### 阶段 2：需求收集 -- 必填：`name`（名称）、`role`（核心职责）、`target_users`（目标用户）、`domain`（专业领域）。 +- 必填（括号内为引导问题示例）：`name`（"起什么名字？"）、`role`（"主要负责什么工作？"）、`target_users`（"谁会使用它？"）、`domain`（"需要哪些专业知识？"）。 - 选填：`style`（沟通风格）、`boundaries`（禁区/红线）、`language`（默认中文）——缺省由领域模板决定。 - 策略：优先从用户自然描述推断，只追问未提及的必填项，每轮最多问 2 个。 @@ -66,6 +66,7 @@ ManageAgent({ ``` - 最简创建只需 `{ "action": "create", "name": "我的助手" }`（其余全自动生成）。 +- 基础创建 `{ "action": "create", "name": "法律顾问", "description": "专注合同审查" }`——只给 name + description，description 会自动填充 persona 的 L0。 - 可选 `id`（kebab-case slug；`core` / `desirecore` 为核心保留标识不可用，含 name 自动生成命中的情况）、`config.llm`（仅 llm 增量；mcp_servers 等敏感字段会被拒，需创建后经界面调整）。 - 创建后智能体立即在线可用，返回 ID 可直接用于 ManageTeam / Delegate。若工具报错（已存在 / 命中保留标识 / config 非白名单字段等），向用户说明原因并按提示调整后重试。 diff --git a/skills/delete-agent/CHANGELOG.md b/skills/delete-agent/CHANGELOG.md index 08b49f9..0535dfe 100644 --- a/skills/delete-agent/CHANGELOG.md +++ b/skills/delete-agent/CHANGELOG.md @@ -1,5 +1,9 @@ # Changelog +## [2.5.2] - 2026-07-19 + +- 复盘补回改写压缩时误删的实质信息：create 的 AgentFS v2/git 版本管理定位、基础创建（name+description 自动填充 persona L0）、需求收集引导问题示例；update/delete/discover 的使用场景与版本管理定位。功能对齐原始意图，仍保留结构性压缩。 + ## [2.5.1] - 2026-07-19 - 提示词改写压缩，功能不变——与 ManageAgent 工具契约重复的说明、装饰框图、重复表改写融入流程，示例就地精简；不外置、不净删，意图全保留。 diff --git a/skills/delete-agent/SKILL.md b/skills/delete-agent/SKILL.md index bb84b42..4e8bce6 100644 --- a/skills/delete-agent/SKILL.md +++ b/skills/delete-agent/SKILL.md @@ -1,7 +1,7 @@ --- name: delete-agent description: 安全删除指定的智能体及其关联数据。删除前会验证智能体状态，支持可选地删除所有会话历史。Use when 用户需要删除不再使用的智能体。 -version: 2.5.1 +version: 2.5.2 type: meta risk_level: high status: enabled @@ -24,14 +24,14 @@ metadata: short_desc: 安全删除智能体及其关联数据，支持多重确认与可选历史清理 description: 安全删除指定的智能体及其关联数据。删除前会验证智能体状态，支持可选地删除所有会话历史。Use when 用户需要删除不再使用的智能体。 body: ./SKILL.zh-CN.md - source_hash: sha256:7037971bb67e0953 + source_hash: sha256:d5eb268aa5209e88 translated_by: human en-US: name: Delete Agent short_desc: Safely delete an Agent and its associated data, with multi-step confirmation and optional history cleanup description: Safely delete a specified Agent and its associated data. Verifies the Agent's state before deletion and optionally removes all session history. Use when the user needs to delete an Agent that is no longer in use. body: ./SKILL.md - source_hash: sha256:7037971bb67e0953 + source_hash: sha256:d5eb268aa5209e88 translated_by: ai:claude-fable-5 translated_at: '2026-07-19' market: @@ -63,7 +63,7 @@ Safely delete a specified Agent and its associated data (filesystem, in-memory s ## L1: Overview -Meta-skill: list candidates → confirm intent (irreversible) → ask whether to delete history → execute via `ManageAgent(action='delete')`. Its value is what the tool can't give: candidate filtering with status guidance, and intent confirmation before deletion. The tool guarantees the multi-way refusals (core agent / self / active state) and team cascading. +Meta-skill: list candidates → confirm intent (irreversible) → ask whether to delete history → execute via `ManageAgent(action='delete')`. Use it to clean up Agents that are no longer used, test/experimental, or need storage reclaimed. Its value is what the tool can't give: candidate filtering with status guidance, and intent confirmation before deletion. The tool guarantees the multi-way refusals (core agent / self / active state) and team cascading. ## L2: Detailed Spec diff --git a/skills/delete-agent/SKILL.zh-CN.md b/skills/delete-agent/SKILL.zh-CN.md index c7fe7dc..b85d0e9 100644 --- a/skills/delete-agent/SKILL.zh-CN.md +++ b/skills/delete-agent/SKILL.zh-CN.md @@ -8,7 +8,7 @@ ## L1：概述 -元技能：列出候选 → 确认意图（不可恢复）→ 询问是否删历史 → `ManageAgent(action='delete')` 执行。价值在工具给不了的部分：候选筛选与状态引导、删除前的意图确认。工具层多重拒绝（核心体 / 自身 / 活跃态）与团队级联由工具保证。 +元技能：列出候选 → 确认意图（不可恢复）→ 询问是否删历史 → `ManageAgent(action='delete')` 执行。用于清理不再使用、测试性/实验性、或需释放存储的智能体。价值在工具给不了的部分：候选筛选与状态引导、删除前的意图确认。工具层多重拒绝（核心体 / 自身 / 活跃态）与团队级联由工具保证。 ## L2：详细规范 diff --git a/skills/discover-agent/CHANGELOG.md b/skills/discover-agent/CHANGELOG.md index d1595a1..cb89eda 100644 --- a/skills/discover-agent/CHANGELOG.md +++ b/skills/discover-agent/CHANGELOG.md @@ -1,5 +1,9 @@ # Changelog +## [2.6.2] - 2026-07-19 + +- 复盘补回改写压缩时误删的实质信息：create 的 AgentFS v2/git 版本管理定位、基础创建（name+description 自动填充 persona L0）、需求收集引导问题示例；update/delete/discover 的使用场景与版本管理定位。功能对齐原始意图，仍保留结构性压缩。 + ## [2.6.1] - 2026-07-19 - 提示词改写压缩，功能不变——与 ManageAgent 工具契约重复的说明、装饰框图、重复表改写融入流程，示例就地精简；不外置、不净删，意图全保留。 diff --git a/skills/discover-agent/SKILL.md b/skills/discover-agent/SKILL.md index 1a25471..f60d67d 100644 --- a/skills/discover-agent/SKILL.md +++ b/skills/discover-agent/SKILL.md @@ -1,7 +1,7 @@ --- name: discover-agent description: 根据用户需求推荐最匹配的智能体，展示候选列表并引导选择。Use when 用户描述需求但不确定该找哪个智能体帮忙，或想浏览可用的智能体。 -version: 2.6.1 +version: 2.6.2 type: procedural risk_level: low status: enabled @@ -24,7 +24,7 @@ metadata: short_desc: 根据需求描述智能推荐最匹配的智能体，引导快速选择 description: 根据用户需求推荐最匹配的智能体，展示候选列表并引导选择。Use when 用户描述需求但不确定该找哪个智能体帮忙，或想浏览可用的智能体。 body: ./SKILL.zh-CN.md - source_hash: sha256:671b1b159567a5a3 + source_hash: sha256:0a1c7b0b1b60e399 translated_by: human en-US: name: Discover Agent @@ -32,7 +32,7 @@ metadata: description: >- Recommend the best-matching Agent based on the user’s needs, show a candidate list, and guide selection. Use when the user describes a need but is unsure which Agent to ask for help, or wants to browse available Agents. body: ./SKILL.md - source_hash: sha256:671b1b159567a5a3 + source_hash: sha256:0a1c7b0b1b60e399 translated_by: ai:claude-fable-5 translated_at: '2026-07-19' market: @@ -64,7 +64,7 @@ Match and recommend the most suitable Agent among registered Agents based on the ## L1: Overview -Procedural skill: understand the need → retrieve with `ManageAgent(action='list')` → semantic match scoring → rank and present → guide selection; on no match, hand off to create-agent automatically. Its value is what the tool can't give: semantic need matching, candidate ranking and presentation, and the create hand-off on no match. `list` / `get` are read-only, approval-free. +Procedural skill: understand the need → retrieve with `ManageAgent(action='list')` → semantic match scoring → rank and present → guide selection; on no match, hand off to create-agent automatically. Applies when the user doesn't know which Agent to pick, wants to browse available Agents, is a new user getting oriented, or is unhappy with the current Agent and wants an alternative. Its value is what the tool can't give: semantic need matching (not keyword search), candidate ranking and presentation, and the create hand-off on no match. `list` / `get` are read-only, approval-free. ## L2: Detailed Spec diff --git a/skills/discover-agent/SKILL.zh-CN.md b/skills/discover-agent/SKILL.zh-CN.md index 055b484..c6ccb55 100644 --- a/skills/discover-agent/SKILL.zh-CN.md +++ b/skills/discover-agent/SKILL.zh-CN.md @@ -8,7 +8,7 @@ ## L1：概述 -流程型技能：理解需求 → `ManageAgent(action='list')` 检索 → 语义匹配评分 → 排序展示 → 引导选择；无匹配时自动衔接 create-agent。价值在工具给不了的部分：需求语义匹配、候选排序与呈现、无匹配时的创建衔接。`list` / `get` 只读免审批。 +流程型技能：理解需求 → `ManageAgent(action='list')` 检索 → 语义匹配评分 → 排序展示 → 引导选择；无匹配时自动衔接 create-agent。适用于用户不知该找哪个智能体、想浏览可用智能体、新用户初次了解、或对当前 Agent 不满意想找替代者。价值在工具给不了的部分：需求语义匹配（而非关键词搜索）、候选排序与呈现、无匹配时的创建衔接。`list` / `get` 只读免审批。 ## L2：详细规范 diff --git a/skills/update-agent/CHANGELOG.md b/skills/update-agent/CHANGELOG.md index c43337c..37f3907 100644 --- a/skills/update-agent/CHANGELOG.md +++ b/skills/update-agent/CHANGELOG.md @@ -1,5 +1,9 @@ # Changelog +## [3.1.3] - 2026-07-19 + +- 复盘补回改写压缩时误删的实质信息：create 的 AgentFS v2/git 版本管理定位、基础创建（name+description 自动填充 persona L0）、需求收集引导问题示例；update/delete/discover 的使用场景与版本管理定位。功能对齐原始意图，仍保留结构性压缩。 + ## [3.1.2] - 2026-07-19 - 提示词改写压缩，功能不变——与 ManageAgent 工具契约重复的说明、装饰框图、重复表改写融入流程，示例就地精简；不外置、不净删，意图全保留。 diff --git a/skills/update-agent/SKILL.md b/skills/update-agent/SKILL.md index aa1c981..6a3747e 100644 --- a/skills/update-agent/SKILL.md +++ b/skills/update-agent/SKILL.md @@ -3,7 +3,7 @@ name: update-agent description: >- 安全更新现有智能体的配置、人格、原则、技能与记忆，输出可审阅 diff 并在确认后应用与提交。Use when 用户要求修改 Agent 行为、安装/卸载技能、调整配置、回滚变更或修订规则。 -version: 3.1.2 +version: 3.1.3 type: meta risk_level: low status: enabled @@ -27,7 +27,7 @@ metadata: description: >- 安全更新现有智能体的配置、人格、原则、技能与记忆，输出可审阅 diff 并在确认后应用与提交。Use when 用户要求修改 Agent 行为、安装/卸载技能、调整配置、回滚变更或修订规则。 body: ./SKILL.zh-CN.md - source_hash: sha256:ceab26ea93a41898 + source_hash: sha256:d33f63306685168e translated_by: human en-US: name: Update Agent @@ -35,7 +35,7 @@ metadata: description: >- Safely update an existing Agent's config, persona, principles, skills, and memory, producing reviewable diffs that are applied and committed only after confirmation. Use when the user asks to modify Agent behavior, install/uninstall skills, adjust config, roll back changes, or revise rules. body: ./SKILL.md - source_hash: sha256:ceab26ea93a41898 + source_hash: sha256:d33f63306685168e translated_by: ai:claude-fable-5 translated_at: '2026-07-19' market: @@ -69,7 +69,7 @@ Safely modify an Agent's configuration, persona, rules, and skills through natur ## L1: Overview -Meta-skill: recognize the edit intent → generate a reviewable diff → user confirmation → apply (structured fields via ManageAgent, free-form files via Read/Write) → receipt, with version rollback. Its value is what the tool can't give: diff preview confirmation, two-path orchestration, rollback; structured fields go through ManageAgent's whitelist + schema validation so invalid config never lands. +Meta-skill: recognize the edit intent → generate a reviewable diff → user confirmation → apply (structured fields via ManageAgent, free-form files via Read/Write) → receipt. Use it to adjust communication style, add/change behavior rules, install/uninstall skills, or batch-upgrade config. The agent directory is version-managed by git with a traceable history, so rollback is supported. Its value is what the tool can't give: diff preview confirmation, two-path orchestration, version rollback; structured fields go through ManageAgent's whitelist + schema validation so invalid config never lands. ## L2: Detailed Spec diff --git a/skills/update-agent/SKILL.zh-CN.md b/skills/update-agent/SKILL.zh-CN.md index 0a0fee6..6d75959 100644 --- a/skills/update-agent/SKILL.zh-CN.md +++ b/skills/update-agent/SKILL.zh-CN.md @@ -8,7 +8,7 @@ ## L1：概述 -元技能：识别修改意图 → 生成可审阅 diff → 用户确认 → 应用（结构化字段走 ManageAgent、自由文件走 Read/Write）→ 回执，并支持版本回滚。价值在工具给不了的部分：diff 预览确认、两路径编排、回滚；结构化字段经 ManageAgent 白名单 + schema 校验，非法配置不落盘。 +元技能：识别修改意图 → 生成可审阅 diff → 用户确认 → 应用（结构化字段走 ManageAgent、自由文件走 Read/Write）→ 回执。用于调整沟通风格、增改行为规则、安装/卸载技能、批量升级配置等。agent 目录由 git 管理版本、历史可追溯，支持回滚。价值在工具给不了的部分：diff 预览确认、两路径编排、版本回滚；结构化字段经 ManageAgent 白名单 + schema 校验，非法配置不落盘。 ## L2：详细规范