Commit Graph

19 Commits

Author SHA1 Message Date
e77c658958 feat: 市场支持团队条目类型并上架合同审查团队 (#110)
## 变更 / What

市场此前只有 `agents` 与 `skills` 两类条目。本 PR 加入**团队(teams)**条目类型,并上架第一条真实团队
listing。

The market supported only `agents` and `skills`. This PR adds a
**teams** entry type and lists the first real team.

## 一、支持团队条目类型

「支持一种新条目类型」实际涉及 4 组共 11 个文件,比表面看到的多:

**客户端契约快照**
- 新增 `schemas/market-team-entry.client.schema.json`,用 esbuild 打包客户端
`packages/schemas/src/market.ts` 后导出生成。用同样方法重新生成
`market-agent-entry.client.schema.json` 验证过管线——字节完全一致(含属性顺序),确认不是手工誊抄。

**Sidecar schema**
- `identity.kind` 枚举加 `team`;新增 `$defs.teamSpec`;接入 `spec.oneOf` 与
kind→spec 派发

**校验器(工作量主要在这里)**
- `scripts/catalog/validate_catalog_metadata.py`:`load_legacy`
原先硬编码只认两个根目录。抽出 `CATALOG_ROOTS` 常量同时驱动允许的父目录集合与错误文案;按 kind 分派客户端 schema
校验;`teams` 进 stats 与 `--require-complete` 覆盖统计;把**严格 provenance
比对**与「可安装 pointer 必须自带不可变 ref」两道门禁扩展到团队
- `scripts/i18n/validate-i18n.py`:**它独立重算计数并逐个校验 `entry.json`**,不接团队会漏校
- `.github/workflows/i18n-validate.yml`:变更检测的 grep 不含 `teams/`——**一个只改
teams 的 PR 会报「无 i18n 相关变更,跳过校验」然后零校验通过**
- 测试:`test_validate_catalog_metadata.py` 29→47,`test_validate_i18n.py`
9→17

**顺带修正一条本就不对的规则**:`icon` 此前被要求「每个 entry.json 都必须有非空内联 SVG」,但运行时 schema 里
`marketAgentSchema` 与 `marketTeamSchema` **都没有 `icon` 字段**(只有 skill
有)。也就是说这条规则对 Agent pointer 同样在强加死重量,只因本仓库暂无 agent pointer 条目而未暴露。改为
`ICON_RENDERED_KINDS = {"skill"}`,agent/team 声明 icon
时给**警告**而非错误,文案说明「下一个维护者会以为改它能改变卡片」。

## 二、上架合同审查团队

`teams/contract-review-team/`(`entry.json` + sidecar)。

**团队条目是 fork 指针卡,不分发正文**:市场只存展示元数据 + git-only `source`,真实定义(`team.json`
/ `members.json` / `shared/`)在 `source.repoUrl` 指向的仓库里。安装即
`forkTeam`,更新即 `git pull`——组合固定,因此**没有** `installPolicy` /
`updatePolicy`。

| 字段 | 值 | 依据 |
|---|---|---|
| `source.ref` | `73cd87a9901cc548871927e9d5dbec8e4cc6c2b1` | v0.1.1
的**完整 SHA**。tag 不是可复现 pin,validator 有测试专门拒绝 |
| `latestVersion` | `0.1.1` | 上游真实 tag,与 `release.version` 交叉校验 |
| `license` | `MIT` | 上游仓库真有 LICENSE,已在 pinned ref 的快照中复验 |
| `redistribution` | `source-pointer-only` |
市场从不打包团队正文,只给指针——这是交付形态,与许可证宽松与否无关 |
| `requiredClientVersion` | `10.0.137` | 六个成员都声明了 `FileDigest`
内置工具,它随该版本发布 |
| `memberCount` / `memberNames` | 6 / 5 名 | schema 规定前者**含**组长、后者**不含**
|
| `availability` | `listing-only` | 见下 |

**`availability` 为什么不是 `installable`**:四项证据满足两项(不可变 pin ✓、已知 license
✓),缺的 `reviewedAt` 与 `governance.compliance`
本质是**一次尚未发生的治理审查**——需要具名方在具体日期针对这个确切 ref 审过许可合规、第三方内容与商标使用。没发生的事不能写进目录。

补充一个事实:本仓库**零个 sidecar 有 `compliance` 块,29 个 pointer 条目全是
listing-only**,`installable` 路径从未在任何真实条目上走过。这不阻止安装——fork 由 `source` 驱动。

**`license.evidencePath` 的基准此前是未定义的**:schema 只说
`safeRelativePath`,没规定相对谁。仓库里仅有的两个先例(`guizang-ppt`、`presentation-forge`)都是
vendored 技能,LICENSE 物理上在条目目录里。按那个读法,pointer 条目写 `evidencePath`
断言的是市场目录下有该文件——对 pointer 永远不成立。新增 `license-evidence` 规则按条目形态分派:vendored
要求文件存在(error),pointer 要求条目已 pin(warning),两种读法写进 README。

## 校验 / Validation

```
test_validate_catalog_metadata.py    47 tests  OK
test_validate_i18n.py                17 tests  OK
test_collection_generator.py         exit 0
validate_catalog_metadata.py --require-complete
  0 error, 116 warning   (agents=1, teams=1, publishableSkills=62, sidecars=64)
validate-i18n.py / --online          0 error, 116 warning
translate.py --check                 exit 0
gen-collection-children.py --check   exit 0
```

116 warnings 即加入团队之前的基线——**本条 listing 贡献 0 个警告**。

真实条目上的反向控制(跑在 rsync 副本上,仓库保持干净):

```
source.kind=zip                 → team-entry-schema (error)
install/updatePolicy 出现       → team-entry-schema (error)
requiredClientVersion 漂移      → legacy-consistency (error)
memberCount 漂移                → legacy-consistency (error)
provenance ref 漂移             → legacy-consistency (error)
可安装但无不可变 ref            → installable-evidence (error)
evidencePath 在未 pin 的 pointer → license-evidence (warning)
```

另用**客户端真实校验器**(`parseMarketTeamEntry`,不是快照)验证条目通过,且多写一个字段会被拒。

## 公开信息边界 / Public information boundary

全树扫描无新增命中。团队内容使用「某某科技(北京)有限公司」这类标准中文占位。

---------

Co-authored-by: yi-ge <mizan57533@gmail.com>
2026-09-01 04:15:45 -04:00
df5959eebf 移除官网展示用 Agent 目录 (#109)
## 变更

- 移除此前为官网展示加入的 7 个 Agent 条目
- 恢复 Market 为真实可复用目录,不再承载官网宣传样例
- 恢复 README 与 manifest 中的 Agent 计数

## 验证

- `scripts/i18n/test_validate_i18n.py`
- `scripts/catalog/test_validate_catalog_metadata.py`
- `scripts/catalog/test_collection_generator.py`
- `scripts/catalog/validate_catalog_metadata.py --require-complete`
- `scripts/i18n/validate-i18n.py`
- 敏感信息与发布边界检查通过
2026-08-31 23:39:53 -04:00
9eb6181e55 feat: 增加公开业务 Agent 目录 (#108)
## 摘要

新增 7 个公开、可复用的 listing-only Agent 条目:

- 内容营销 Agent
- 标书协作 Agent
- 合同审查 Agent
- 工程图校核 Agent
- 检验报告 Agent
- 研究证据 Agent
- 流程运营 Agent

这些条目用于发现和展示能力蓝图,不声明已安装、已连接外部系统或可替代专业人员签发。工程、检验、法律和研究类条目均保留人工复核边界。

## Summary

Add seven public, reusable, listing-only Agent entries for content
marketing, tender collaboration, contract review, engineering drawing
review, inspection reports, research evidence, and workflow operations.

The entries are discovery blueprints only. They do not claim installed
tools, connected systems, or authority to replace qualified professional
review and sign-off.

## 数据变更 / Data changes

- Market version: `1.3.0`
- Agent count: `1 → 8`
- Every Agent includes bilingual legacy metadata and `CatalogItemV1`
sidecar data
- All new entries remain `listing-only` with unknown license/platform
facts where evidence is absent

## 验证 / Validation

- i18n unit tests: 9/9
- catalog validator tests: 29/29
- collection generator tests: 4/4
- catalog validation: 0 errors
- i18n validation: 0 errors
- secret/private-key scan: 0 findings
2026-08-31 22:43:30 -04:00
d76db984b6 fix: 对齐 Agent 指针目录与客户端校验契约 (#103)
## 问题 / Problem

市场 CI 要求每个 Agent 条目都有 catalog sidecar,但 sidecar 校验器只接受相邻的
agent.json。客户端已支持的 Agent entry.json 指针因此无法满足完整覆盖门禁。

The catalog completeness gate requires sidecars for every Agent, while
the validator previously read only agent.json. Valid Agent pointer
entries could not satisfy CI.

## 修改 / Changes

- Agent 主文件严格二选一:内联 agent.json 或指针 entry.json;目录 slug 与安装源 UUID 保持分离。
- 使用从主仓固定提交导出的完整客户端 Agent entry Schema,先校验原始类型、字段、版本、路径和策略组合,再比较
sidecar。
- 对齐 latestVersion、固定来源、许可/治理、兼容性和有效的缺省 market/market 策略,拒绝 sidecar
单方面提升托管权限。
- 未修改产品条目、manifest、现有 sidecar Schema 或 CI 完整性要求。

Agent pointers now pass the pinned client input schema before source
metadata consistency checks. Effective default policies are compared
without promoting catalog metadata into authority. Existing inline
Agents and Skills retain their validation paths; no entries or CI
requirements change.

## 验证 / Validation

- 29 + 4 + 9 项定向 Python 测试通过。
- 完整 i18n、catalog --require-complete、translation freshness 检查通过;116
条既有警告与基线一致,无新增。
- 原始客户端 Schema 与固定主仓来源逐项比较一致(仅增加溯源注释)。
- 独立代码审查发现的原始契约与缺省策略问题已修复并复核。
- 公开信息边界检查覆盖完整工作树、隐藏文件、链接目标与新增 Git 元数据,通过。

Targeted tests, full catalog/i18n/freshness validation, source-schema
comparison and independent review passed. Existing warnings are
unchanged. This PR repairs catalog validation; it does not claim runtime
installation of a new product.

---------

Co-authored-by: yige <yige@yigedeMacBook-Neo.local>
2026-08-31 06:21:04 -04:00
a205ef20f0 feat: 迁移统一目录元数据契约 (#102)
## 中文

- 为 System Agent、34 个 Builtin Skill、28 个 Pointer/Collection 条目增加 catalog
sidecar
- 覆盖 147 个 collection child,并固定可证明的来源;无法证明的内容保持 listing-only/unknown
- 增加 strict Schema、validator、collection check 与 CI 完整性门禁

## English

- Add catalog metadata sidecars for the System Agent, 34 built-in
Skills, and 28 pointer/collection entries
- Cover 147 collection children while keeping unverifiable facts
listing-only or unknown
- Add strict schemas, validators, deterministic collection checks, and
CI completeness gates

## 验证 / Verification

- Catalog validator 17/17
- Collection generator 4/4
- 63 sidecars, 147 children, zero errors
2026-08-31 04:10:49 -04:00
mashagua
98ffc8fe92 feat: 内置技能全量收录 presentation-forge (#83)
## 概述
将 PPT 工作流技能 **presentation-forge**(原 codex-ppt-skill)以 **builtin
内置技能**形态全量收录进 DesireCore 官方市场。

> 注:本 PR 最初以 entry.json pointer 形态提交,现按仓库负责人意见改为 builtin 层全量
vendoring。分支保留两个提交(pointer → builtin 转换)。

## 形态:builtin 全量 vendoring(遵循 guizang-ppt 先例)
- 全量内容进 `skills/presentation-forge/`:`SKILL.md` + `SKILL.zh-CN.md` +
`references/` + `scripts/` + `styles/`(9 套风格)+ `templates/` +
`schemas/`。
- builtin frontmatter:`version/type/risk_level/status/tags` +
`metadata.i18n`(zh-CN/en-US)+
`market.icon/category/maintainer`,`category: creative`。
- 列入 `builtin-skills.json`(33 项)。
- 附 `LICENSE`(MIT)+ `NOTICE.md` +
`_desirecore/{frontmatter.yaml,upstream.json}` 溯源。
- 溯源 commit:`mashagua/presentation-forge@b7b1a9c`(MIT)。
- 排除非运行内容:`tests/` 夹具、未被任何 vendored 文件引用的 1.3MB 流程图、Codex `agents/` 绑定。

## 变更
- 新增 `skills/presentation-forge/`(全量内容,约 440KB)
- `builtin-skills.json`:新增 `presentation-forge`(32 → 33)
- `manifest.json`:`stats.totalSkills` 60 → 61,`version` 1.2.26 →
1.2.27,`lastUpdated` → 2026-08-10
- `README.md`:built-in 32 → 33、external 29 → 28、total 61 不变,两处代码块同步

## 验证
```
uv run scripts/i18n/validate-i18n.py
OK: no i18n issues found.
```
stats 公式核对:entry.json 目录 28 + SKILL.md 目录 33 = 61 = manifest.totalSkills
✓

---------

Co-authored-by: Yige <a@wyr.me>
Co-authored-by: yige <yige@yigedeMacBook-Neo.local>
2026-08-23 23:31:26 +08:00
mashagua
e15f152ed0 feat: 新增女娲与 Humanizer 双语版三个第三方入口 (#82)
## 概述

以 `entry.json` pointer 形式收录三个第三方技能,均为 MIT、社区维护、SHA 锁定:

| id | 上游 | category | ref | 简介 |
|---|---|---|---|---|
| `nuwa-skill` |
[alchaincyf/nuwa-skill](https://github.com/alchaincyf/nuwa-skill) |
productivity | `27642f5` | 输入一个名字即自动调研→提炼→验证,把任何人的心智模型、决策启发式与表达 DNA
蒸馏成可运行的人物 Skill |
| `humanizer` | [blader/humanizer](https://github.com/blader/humanizer)
| creative | `523374d` | 基于维基百科「Signs of AI writing」指南去除文本 AI 痕迹,纯
Markdown 可跨 agent 运行 |
| `humanizer-zh` |
[op7418/Humanizer-zh](https://github.com/op7418/Humanizer-zh) | creative
| `91f3d39` | Humanizer 汉化版,按中文写作习惯去痕,附核心规则、快速检查清单与质量评分 |

后两者是同一技能的英文原版与汉化版,故合并在一个 PR 内提交便于对照 review。

## 遵循 ADR-038(市场元数据注册表与两层技能模型)

- **只放元数据、不放内容**:仅新增三个 `skills/<id>/entry.json`,正文留在上游源仓库,不 vendoring
任何源码或二进制。
- **市场第三方层**:三者均 `stewardship: community`、`license:
MIT`、`redistribution: allowed`。
- **source pointer**:`kind=git` + repoUrl + repoBranch,`ref` 锁定完整 SHA
保证可复现。
- **轻量 i18n**:仅 name/shortDesc(zh-CN / en-US),列表本地化可离线。
- **无需 `source.path`**:三个上游的 `SKILL.md` 均在仓库根目录(已用 GitHub API 核对树结构),不涉及
#81 修复的 pointer 路径问题。
- **不声明 children**:`nuwa-skill` 的 `examples/` 下 15 个人物 perspective
是女娲的产出示例而非并列子技能,按 `gen-collection-children.py` 的排除规则不计入。
- 第三方 entry 未进 `builtin-skills.json`。

## 变更

- 新增
`skills/nuwa-skill/entry.json`、`skills/humanizer/entry.json`、`skills/humanizer-zh/entry.json`
- `manifest.json`:`stats.totalSkills` 57 → 60,`version` 1.2.24 →
1.2.25,`lastUpdated` → 2026-08-09
- `README.md`:external 25 → 28、total 57 → 60,外部条目清单按字母序插入三个新入口

## 验证

\`\`\`
$ uv run scripts/i18n/validate-i18n.py
OK: no i18n issues found.
\`\`\`

统计核对:`entry.json` 目录 28 + `SKILL.md` 目录 32 = 60,与
`manifest.stats.totalSkills` 一致。
2026-08-09 18:14:38 +08:00
20b29df7a4 feat: 发布通用人效与资源优化能力
增加跨行业的人效与资源优化需求澄清、模型求解与独立验收能力,并固化公共市场的信息边界与发布前检查。
2026-08-07 23:55:01 +08:00
4faba8602f feat: 收录视频观看 Skill
通过市场 i18n/schema validator、自动翻译检查和 Copilot review gate;source pointer 固定到 desirecore-agent/codex-watch-video-skill 的 main commit。
2026-08-07 23:54:22 +08:00
mashagua
b4cafe4edd feat: 新增宝玉 Skills 与 Marketing Skills 两个第三方入口 (#64)
以 entry.json pointer 形式收录两个第三方技能合集(均为 MIT、community、SHA 锁定):

- baoyu-skills(JimLiu/baoyu-skills,creative,上游 21 个技能)
- marketingskills(coreyhaines31/marketingskills,business,上游 49 个技能)

同步更新:
- manifest.json:totalSkills 54 → 56,version 1.2.18 → 1.2.19,lastUpdated → 2026-08-06
- README.md:external 22 → 24、total 54 → 56,外部条目清单补入两个新入口,并补回此前遗漏的 karpathy-guidelines、last30days
2026-08-07 23:54:03 +08:00
5d50b66d55 feat: 新增代码智能内置技能 (#61)
## 变更摘要

- 新增中英文 `code-intelligence` 内置技能,按需暴露隐藏的 `Lsp` 工具
- 记录 9 种语义导航操作、目录权限边界、缺少语言服务器时的降级策略
- 要求客户端版本 `10.0.94`,避免旧客户端安装后缺失工具
- 更新内置技能清单、市场统计和版本

## 验证

- `uv run --with httpx --with ruamel-yaml scripts/i18n/validate-i18n.py`
- `uv run --with httpx --with ruamel-yaml scripts/i18n/translate.py
--check`

## Summary

Adds the bilingual `code-intelligence` built-in skill, exposes the
hidden `Lsp` tool only when the skill is active, documents its
permission and fallback behavior, and updates the market manifest and
counts.
2026-07-22 20:03:56 +08:00
mashagua
57493b89a0 feat(skills): 新增 watchless 与 impeccable 两个 external skill (#60)
## 背景

新增两个社区 skill 的 marketplace 指针条目,两者此前均不在 market 中。

## 改动

新增 2 个 external entry(`entry.json`,git 指针型,含 `zh-CN` / `en-US` i18n):

| skill | category | license | source | 简介 |
|---|---|---|---|---|
| watchless | media | MIT |
[chenzixin1/watchless](https://github.com/chenzixin1/watchless) |
将视频转成以关键帧截图为主线的完整视觉文档,输出 HTML/PDF/ZIP |
| impeccable | design | Apache-2.0 |
[pbakaus/impeccable](https://github.com/pbakaus/impeccable) | 让 AI
更懂前端设计的设计语言,覆盖 UX/可访问性/排版/配色/动效/设计系统 |

同步更新:
- `README.md`:external `20 → 22`、total `50 → 52`,外部条目列表按字母序插入
`impeccable`、`watchless`
- `manifest.json`:`stats.totalSkills` `50 → 52`

## 规则遵循

- entry.json 字段对齐现有 git 型指针(如 mattpocock-skills),格式一致
- category 使用 `categories.json` 已声明的合法 slug(media / design)
- `source.ref` 固定到当前最新 commit,保证可复现
- 两个上游仓库均为标准 skill(含 SKILL.md / skill 定义),许可允许再分发

## 验证

- 本地运行 `scripts/i18n/validate-i18n.py`:`OK: no i18n issues found.`(退出码
0)
- entry.json 均为合法 JSON,i18n 完整
2026-07-19 19:19:33 +08:00
9273d4378a docs: update market catalog counts (#51)
## Summary

- align the README catalog summary with the current market tree
- report 20 external entries and 50 total publishable skills

## Validation

- `uv run scripts/i18n/validate-i18n.py`
2026-07-16 20:53:31 +08:00
f8d6ddeaf3 feat(market): 为外部技能补充图标 (#50)
## Summary / 摘要

Add inline SVG icons to all 20 external pointer skills, so their cards
no longer fall back to an empty icon. The market catalog version is
bumped from `1.2.8` to `1.2.9`.

为全部 20 个外部 pointer skill 补齐内联 SVG 图标,市场卡片不再显示为空;市场版本由 `1.2.8` 升至
`1.2.9`。

## Compatibility / 兼容性

Depends on desirecore/desirecore#1177, which permits the `icon` field in
strict pointer-entry validation and forwards it through the offline
list/detail responses. That PR must merge first.

## Skill → icon screenshot / Skill 与图标截图

The preview labels every card with its display name and id.

![External skill icon
preview](https://raw.githubusercontent.com/desirecore/market/feat/external-skill-icons/docs/assets/external-skill-icons-v1.2.9.svg)

Covered skills: `agent-reach`, `ai-news-radar`, `amap-jsapi-skill`,
`dingtalk-api`, `flyai-skill`, `follow-builders`,
`ian-xiaohei-illustrations`, `karpathy-guidelines`, `khazix-skills`,
`larksuite-cli`, `last30days`, `luckin-my-coffee`, `mattpocock-skills`,
`minimax-image-gen`, `minimax-tts`, `mt-paotui-for-client`,
`netease-skills`, `taste-skill`, `wechatpay-skills`, and `wecom-cli`.

## Validation / 验证

- `uv run scripts/i18n/validate-i18n.py`
- `uv run scripts/i18n/translate.py --check`
- Parsed all 20 `entry.json` icons as SVG XML
- `git diff --check`
- Rendered the committed preview asset locally
2026-07-16 19:59:41 +08:00
mashagua
f1e313d0d3 Add three MIT community skill entries (agent-reach, ian-xiaohei-illustrations, khazix-skills) (#45)
## Summary

按 ADR-038《市场元数据注册表与两层技能模型》,以 `entry.json` pointer 形式收录三个第三方 community
skill。**仅登记元数据,正文全部留在各自源仓库**,不向 market 仓库 vendoring 任何源码/二进制。

| id | 源仓库 | license | stewardship | redistribution | category |
|----|--------|---------|-------------|----------------|----------|
| `agent-reach` |
[Panniantong/agent-reach](https://github.com/Panniantong/agent-reach) |
MIT | community | allowed | research |
| `ian-xiaohei-illustrations` |
[helloianneo/ian-xiaohei-illustrations](https://github.com/helloianneo/ian-xiaohei-illustrations)
| MIT | community | allowed | media |
| `khazix-skills` |
[KKKKhazix/khazix-skills](https://github.com/KKKKhazix/khazix-skills) |
MIT | community | allowed | productivity |

## Changes

- 新增 `skills/agent-reach/entry.json`(SKILL.md 位于 `agent_reach/skill`,已用
`source.path` 指向)
- 新增 `skills/ian-xiaohei-illustrations/entry.json`(SKILL.md 位于同名子目录,已用
`source.path` 指向)
- 新增 `skills/khazix-skills/entry.json`(多技能合集,指向仓库根)
- 三条 `source.ref` 均固定到源仓库当前 HEAD commit,保证可复现
- `manifest.json`:`stats.totalSkills` 45 → 48,`lastUpdated` 更新为
2026-07-09
- `README.md`:同步计数(external 15→18 / total 45→48)与外部条目列表

## Compliance (ADR-038)

- 三个源仓库均为 MIT,`redistribution: allowed`,可分发
- 未向 market 仓库引入任何 upstream 源码树 / zip / 二进制
- 字段遵循现有 `entry.json` 约定(参照 mattpocock-skills / netease-skills 等既有条目)
2026-07-09 21:37:59 +08:00
1b002e5778 强化市场校验与索引元数据
合并市场索引、分类、i18n 校验、skill-creator 工具和已修改 skill 版本号更新。
2026-07-07 21:14:31 +08:00
mashagua
310378643b Add 3 community skill pointers (MIT) (#36)
## What

按 ADR-038(市场元数据注册表与两层技能模型)以「元数据 + pointer」方式收录 3 个第三方 skill 仓库(均为 MIT):

| id | 上游 | 许可 | 分支 |
|----|------|------|------|
| `mattpocock-skills` |
[mattpocock/skills](https://github.com/mattpocock/skills) | MIT | main |
| `ai-news-radar` |
[LearnPrompt/ai-news-radar](https://github.com/LearnPrompt/ai-news-radar)
| MIT | master |
| `taste-skill` |
[Leonxlnx/taste-skill](https://github.com/Leonxlnx/taste-skill) | MIT |
main |

## How

- 各仅新增 `skills/<id>/entry.json` 一个文件(每个 24 行),**不 vendor
任何上游源码**,正文按需从上游获取。
- 三个上游均为 **MIT**(可分发),故
`stewardship=community`、`redistribution=allowed`。
- `source` 指针格式对齐现有 `follow-builders` 条目(注意 ai-news-radar 默认分支为
`master`)。

## Compliance (ADR-038)

- [x] 第三方内容不进 market 仓库,只放元数据 + pointer
- [x] 每条标注 stewardship / license / redistribution
- [x] 改动量极小(3 files, +72),无 upstream/ / .zip / .gif 膨胀

---------

Co-authored-by: Yige <a@wyr.me>
2026-07-07 17:02:16 +08:00
8bdda4afb1 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
DesireCore
b09592338c Initial market data: 6 agents, 5 skills 2026-02-16 21:48:24 +08:00