|
|
bffb9d24b4
|
fix: 修复 desirecore PR #533 Copilot 评审反馈的 7 项内容问题 (#2)
[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 01:08:46 +08:00 |
|
|
|
1f7c8b9673
|
feat: skills i18n 改造（schemaVersion 1.1，零向后兼容） (#1)
* feat: skills i18n 改造 — schemaVersion 1.1，零向后兼容
把 21 个 skills + 1 个 agent + manifest/categories 全量迁移到 schemaVersion 1.1
的 i18n 结构，配套 CI AI 翻译流水线（GitHub Models）与本地工具链。
## 关键变更
### 数据结构（破坏性，schemaVersion 1.0 → 1.1）
- SKILL.md: 顶层 name 改为 ASCII slug（== 目录名，符合 agentskills.io 规范）；
中文显示名/short_desc/description 全部迁入 metadata.i18n.<locale>
- agents/<id>/agent.json: shortDesc/fullDesc/tags/persona.{role,traits} 迁入
i18n.<locale>；changelog[].changes 改为 { <locale>: string[] } 对象
- categories.json: 每个分类的 label/description 迁入 i18n.<locale>，顶层只剩
color/icon
- manifest.json: 加 supportedLocales / defaultLocale；顶层 description 迁入
i18n.<locale>
### Body 文件结构
- 根 SKILL.md = frontmatter + default_locale (en-US) body
- SKILL.<locale>.md = 各 locale 的 markdown body（首行 <!-- locale: xx --> 自校验）
### 工具链（scripts/i18n/）
- glossary.json: zh→en 术语表 + do_not_translate 白名单
- schema/skill-frontmatter.schema.json: i18n frontmatter JSON Schema
- validate-i18n.py: 8 条校验规则（name 合规 / locale 完整性 / hash 一致性等）
- translate.py: GitHub Models / Anthropic 双 backend，sha256 增量翻译
- migrate.py: 一次性迁移脚本（旧格式 → i18n 结构）
### CI（.github/workflows/）
- i18n-validate.yml: PR 触发跑 validate + translate --check
- i18n-translate.yml: PR 触发用 GitHub Models（默认 openai/gpt-5-mini）翻译缺失
locale，自动追加 commit；可切到 ANTHROPIC_API_KEY 走 Claude
### 文档
- docs/I18N.md: 作者贡献指南（schema 说明 / 提交流程 / 常见问题）
- README.md: 加多语言段落
## 验证
- uv run scripts/i18n/validate-i18n.py: OK，49 文件 0 错误
- uv run scripts/i18n/translate.py --check: 0 stale locale
- 21 skills 标题数 zh-CN == en-US 严格对齐（最大 66=66）
- skills-ref 规范校验：全部通过（顶层 name ASCII slug + description 单字段）
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
* fix(i18n): 修复 PR #1 review 反馈的 6 项问题
- schema: translated_by 正则放宽为 ^(human|ai:[A-Za-z0-9._:/-]+)$，接受
'ai:github:openai/gpt-5-mini' 这类 backend:model 形式（CI 翻译输出格式）
- README + docs/I18N.md: 修正"CI 用 Claude API"误导描述，正确说明默认是
GitHub Models（openai/gpt-5-mini）+ GITHUB_TOKEN，可选切到 Anthropic
- skills/minimax-tts/SKILL.md & SKILL.zh-CN.md: 删除多余的 ``` 闭合，避免
Markdown 后续渲染错乱
- skills/docx/SKILL.md: 翻译时丢失的 • Unicode escape 示例已恢复，
与 zh-CN 版本对齐
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|
2026-05-05 00:26:33 +08:00 |
|
|
|
1a50969b93
|
feat: 拆分 environment-setup 为 Python/Node.js 运行时双核心 + 父级路由
新增双核心 skill（深度集成 DesireCore Hatch/Volta + HTTP API + Socket.IO）：
- python-runtime v1.0.1：Python 运行时管理
· 四级降级：HTTP API → Hatch CLI 绝对路径 → 系统包管理器 → pyenv
· references：hatch-desirecore / pyenv-fallback / virtualenv / troubleshooting
· scripts/probe-python.sh：输出 JSON 快照供 Claude 解析决策
- nodejs-runtime v1.0.1：Node.js 运行时管理
· 四级降级：HTTP API → Volta CLI → 系统包管理器/NodeSource → nvm/fnm
· references：volta-desirecore / nvm-fallback / package-managers / troubleshooting
· scripts/probe-node.sh：输出 JSON 快照（含 volta_tools / package_json_volta 等）
environment-setup → dev-environment-setup v2.0.1（重命名 + 重写为 router）：
- 从 1380 行手册瘦身为 ~150 行索引
- 仅负责容器（Docker/Podman）/ WSL2 / 办公依赖速查 / 系统工具
- references/desirecore-runtime.md 沉淀 Hatch/Volta 路径表 + HTTP API 速查 +
Socket.IO 事件契约，作为两个核心 skill 的共享底座
- references/decision-tree.md 定义四级降级决策树
- scripts/probe.sh + probe.ps1 系统级 JSON 探测
三个 SKILL.md 的 L0 改为场景驱动结构（何时使用 / 何时不要用 / 怎么做），
让 AI 凭名字与 L0 即可判断匹配场景。
注册更新：
- builtin-skills.json：新增 python-runtime / nodejs-runtime / dev-environment-setup
（原 environment-setup 移除），按字母序，共 21 个 skill
- manifest.json：totalSkills 19→21，lastUpdated 2026-05-02
下游同步：
- docx / pdf / xlsx / pptx 中的环境引用从 environment-setup 拆分为
python-runtime / nodejs-runtime / dev-environment-setup 三向指引
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|
2026-05-02 13:30:23 +08:00 |
|
