mirror of https://git.openapi.site/https://github.com/desirecore/market.git synced 2026-07-23 04:44:36 +08:00

Files

Yige 74be106952 fix(skills): 补回 #56 压缩时误删的实质信息（意图对齐） (#57 )

## 摘要 / 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).

2026-07-19 16:14:22 +08:00

3.1 KiB

Raw Blame History

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 工具契约重复的说明、装饰框图、重复表改写融入流程，示例就地精简；不外置、不净删，意图全保留。

[3.1.1] - 2026-07-18

修正示例字段名：communicationStyle → communication_style、must → must_do；personality 示例改为字符串数组
get 返回示例对齐真实输出格式（## persona.md / ## principles.md 段落含分层 markdown 原文，客户端 ≥ 10.0.90）
附录补充结构化字段名固定清单（persona L1.role/personality/communication_style；principles L1.must_do/must_not/priority）

[3.1.0] - 2026-07-18

结构化字段（name/description/llm/persona/principles）改经进程内内置工具 ManageAgent 的 update 动作更新（白名单 + schema 校验 + 合并语义），移除对 agent.json / persona.md / principles.md 的直接 Write 指引
补充合并语义说明：结构化 persona/principles 为字段级合并（省略字段保留原值）、markdown 字符串为整体替换、config.llm 为增量浅合并；非法配置不落盘
补充确认行为：更新自身免确认、更新其他智能体触发用户确认、核心智能体（desirecore/core）拒绝更新
补充错误处理：config 非白名单字段被拒、schema 校验失败、部分字段写入失败仅重试失败字段
记忆、技能、工具等自由格式文件仍用 Read/Write 直接编辑（注意 _protected-paths.yaml 受保护路径），版本回滚按目标类型分流（结构化走 ManageAgent、自由文件直接写回）
声明 required_client_version: 10.0.90

[3.0.0] - 2026-03-17

Breaking：从 HTTP API 迁移到 AgentFS 直接文件操作
移除所有 HTTP API 端点引用（PUT persona/principles/files）
变更应用改为直接读写 ${DESIRECORE_ROOT}/agents/<agentId>/ 下的文件
回滚流程改用 git log/show 命令查看历史版本
错误处理改为文件系统错误（文件不存在、权限不足等）

[2.4.0] - 2026-02-28

阶段 5"变更应用"统一为 HTTP API 调用，移除所有 Git 操作示例
AgentFS 背景知识提取到共享文件 _agentfs-background.md，消除重复
受保护路径统一引用 _protected-paths.yaml
新增 Persona 修改示例（GET → 修改字段 → PUT 流程）
精简版本回滚流程，移除 Git 命令示例
错误处理移除 Git 相关条目，改为 API 错误码

[2.2.0] - 2026-02-27

新增结构化 persona/principles API 端点（GET/PUT）说明
推荐使用结构化 API 替代原始文件写入

[2.1.0] - 2026-02-26

移除 fetch_api 依赖，改为通过 Bash/curl 调用 HTTP API；API 地址由 system prompt 注入；新增 PUT /api/agents/:id/files/* 端点说明

3.1 KiB Raw Blame History Unescape Escape

Changelog

[3.1.3] - 2026-07-19

[3.1.2] - 2026-07-19

[3.1.1] - 2026-07-18

[3.1.0] - 2026-07-18

[3.0.0] - 2026-03-17

[2.4.0] - 2026-02-28

[2.2.0] - 2026-02-27

[2.1.0] - 2026-02-26

3.1 KiB

Raw Blame History