yi-ge 8047c8b0dc fix: 修复 desirecore PR #533 Copilot 评审反馈的 7 项内容问题
[desirecore PR #533](https://github.com/desirecore/desirecore/pull/533) 把
market 全局技能快照同步到主仓库,Copilot 自动评审命中 7 处文档与代码
不一致问题,全部根因在 market 的 skill 文档;本 PR 在源头修复,让下次
sync-global-skills 自然带过去。

修复内容:

1. disable-model-invocation 语义描述反向(3 处文件 × 2 语言 = 5 处编辑)
   - skill-creator/SKILL.md (en-US)
   - skill-creator/SKILL.zh-CN.md
   - manage-skills/SKILL.md (en-US)
   - manage-skills/SKILL.zh-CN.md
   - 注:references/desirecore-format.md 已在 PR #1 解冲突时一并修好

   实际代码逻辑(lib/agent-service/skills/parser.ts):只有显式
   `disable-model-invocation: false` 才会被加入 system prompt 自动加载列表,
   `true` 或缺省都会跳过自动注入、需显式 Skill 工具调用。文档原描述把这两个
   值的语义对调了,且错误地宣称存在 L0/L1 vs L0+L1+L2 的"分层加载机制"
   (runtime 不区分这三个层级,加载就是整篇 SKILL.md)。

2. dev-environment-setup/references/probe-snapshot.md 协议字段类型 / 超时承诺
   - desirecore_port_file: string → boolean(probe.sh 输出 ${PORT_FILE_EXISTS}
     原生 bool;probe.ps1 输出 PowerShell bool;JSON 序列化均为 true/false)
   - "CLI 调用最长 5s" → "CLI 调用依赖工具自身实现,无显式 timeout 包装,
     正常情况通常 <5s 完成"(HTTP probe 确有 0.5s/1s timeout,但 --version
     这类 CLI 没有 timeout 5s 包装,文档原文承诺超出实现)

3. minimax-music-gen 使用过时的 provider 字段(应为 providerId)
   - skills/minimax-music-gen/SKILL.md(3 处)
   - skills/minimax-music-gen/SKILL.zh-CN.md(3 处)
   - 与 sibling minimax-tts/image-gen/video-gen 对齐,使用
     `"providerId": "provider-minimax-media-001"`,避免 media-proxy 路由到
     coding/token plan 等同名 provider

版本与日期:

- skill-creator: 1.0.1 → 1.0.2
- manage-skills: 1.0.2 → 1.0.3
- dev-environment-setup: 2.0.1 → 2.0.2
- minimax-music-gen: 1.1.1 → 1.1.2
- 上述 4 个 SKILL.md 的 metadata.updated_at 与 manifest.json#stats.lastUpdated
  统一为 2026-05-05

i18n 处理:

按 PR #1 修复模式(commit 2a21e8e),同步编辑英文源(SKILL.md = en-US default)
与中文翻译(SKILL.zh-CN.md = source),不动 metadata.i18n.<locale>.source_hash /
translated_at 字段(CI translate.py 维护)。
2026-05-05 00:47:30 +08:00

DesireCore Market

DesireCore 官方市场仓库,存放经过官方验证的 Agent 和 Skill 定义。

目录结构

.
├── manifest.json      # 仓库元数据
├── categories.json    # 分类配置
├── README.md          # 本文件
├── agents/            # Agent 定义目录
│   ├── task-master/
│   │   └── agent.json
│   ├── code-reviewer/
│   │   └── agent.json
│   ├── business-analyst/
│   │   └── agent.json
│   ├── writing-coach/
│   │   └── agent.json
│   ├── translator/
│   │   └── agent.json
│   └── data-analyst/
│       └── agent.json
└── skills/            # Skill 定义目录
    ├── web-search/
    │   └── skill.json
    ├── file-manager/
    │   └── skill.json
    ├── calendar-sync/
    │   └── skill.json
    ├── doc-parser/
    │   └── skill.json
    └── email-client/
        └── skill.json

Agent 清单

ID 名称 分类 定位
task-master 任务管家 效率 智能任务规划与追踪专家
code-reviewer 代码审查官 开发 资深代码审查与质量把控
business-analyst 商业洞察师 商业 数据驱动的商业分析顾问
writing-coach 写作教练 创意 从构思到润色的写作伙伴
translator 译界通 沟通 跨文化沟通与专业翻译
data-analyst 数据洞察师 数据 数据科学与业务洞察专家

Skill 清单

ID 名称 分类 风险等级 功能概述
web-search 网络搜索 效率 智能搜索与信息聚合
file-manager 文件管家 开发 本地文件系统管理
calendar-sync 日历同步 商业 日历服务连接与调度
doc-parser 文档解析器 数据 50+ 格式文档解析
email-client 邮件助理 沟通 智能邮件管理与起草

数据格式

Agent 定义 (agents/{id}/agent.json)

{
  "id": "string",
  "name": "string",
  "avatar": { "t": "string", "bg": "string" },
  "shortDesc": "string",
  "fullDesc": "string",
  "category": "productivity|development|business|creative|communication|data",
  "tags": ["string"],
  "version": "semver",
  "latestVersion": "semver",
  "updatedAt": "YYYY-MM-DD",
  "maintainer": { "name": "string", "verified": boolean },
  "downloads": number,
  "rating": number,
  "ratingCount": number,
  "installStatus": "not_installed",
  "persona": {
    "role": "string",
    "traits": ["string"],
    "tools": ["string"]
  }
}

Skill 定义 (skills/{id}/skill.json)

{
  "id": "string",
  "name": "string",
  "icon": "lucide-icon-name",
  "shortDesc": "string",
  "fullDesc": "string",
  "category": "productivity|development|business|creative|communication|data",
  "tags": ["string"],
  "version": "semver",
  "latestVersion": "semver",
  "updatedAt": "YYYY-MM-DD",
  "maintainer": { "name": "string", "verified": boolean },
  "downloads": number,
  "rating": number,
  "ratingCount": number,
  "installStatus": "not_installed",
  "riskLevel": "low|medium|high",
  "requires": {
    "tools": ["string"],
    "connections": ["string"]
  },
  "compatibleAgents": ["string"]
}

设计令牌

头像背景色使用 DesireCore 设计系统:

  • Green (#34C759): 效率、商业类
  • Blue (#007AFF): 开发、沟通类
  • Purple (#AF52DE): 创意、数据类

多语言i18n

仓库支持多语言展示与多语言 SKILL.md 正文。当前覆盖 zh-CN(简体中文,源语言)与 en-US(英文,默认 fallbackmanifest.json#supportedLocales 声明。

  • 作者只交一种语言CI 自动翻译为其余语言。CI 默认走 GitHub Modelsopenai/gpt-5-mini,使用 repo 内置 GITHUB_TOKEN + permissions: models: read);可切到 Anthropic Claude设置 vars.TRANSLATE_BACKEND=anthropicsecrets.ANTHROPIC_API_KEY)。
  • 顶层 name 字段为 ASCII slug== 目录名),中文显示名安放在 metadata.i18n.zh-CN.name,符合 agentskills.io 规范
  • 正文文件SKILL.md(默认语言)+ SKILL.<locale>.md(其他语言)兄弟文件。

工具:

# 校验 i18n 完整性
uv run scripts/i18n/validate-i18n.py

# 检查哪些 locale 缺翻译(不调 API
uv run scripts/i18n/translate.py --check

# 本地翻译:默认 GitHub Models需要 fine-grained PAT 含 Models: Read
GITHUB_TOKEN=ghp_... uv run scripts/i18n/translate.py

# 切到 Anthropic Claude
TRANSLATE_BACKEND=anthropic ANTHROPIC_API_KEY=sk-ant-... \
  uv run scripts/i18n/translate.py

详细规范见 docs/I18N.md

许可证

MIT License - 详见 LICENSE

Description
DesireCore 官方市场仓库。
Readme 4.4 MiB
Languages
Python 73.1%
HTML 23.8%
Shell 1.7%
JavaScript 1.1%
PowerShell 0.3%