mirror of
https://git.openapi.site/https://github.com/desirecore/market.git
synced 2026-06-06 04:30:42 +08:00
bffb9d24b4ebd8c766b091f45fce48b56a1d3578
[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 维护)。
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(英文,默认 fallback),由 manifest.json#supportedLocales 声明。
- 作者只交一种语言,CI 自动翻译为其余语言。CI 默认走 GitHub Models(
openai/gpt-5-mini,使用 repo 内置GITHUB_TOKEN+permissions: models: read);可切到 Anthropic Claude(设置vars.TRANSLATE_BACKEND=anthropic与secrets.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
Languages
Python
73.1%
HTML
23.8%
Shell
1.7%
JavaScript
1.1%
PowerShell
0.3%