Skip to content

feat(registry): establish catalog contract v2 foundation - #2

Merged
quantskills-GuoYJ merged 27 commits into
mainfrom
codex/catalog-foundation-20260810
Aug 10, 2026
Merged

feat(registry): establish catalog contract v2 foundation#2
quantskills-GuoYJ merged 27 commits into
mainfrom
codex/catalog-foundation-20260810

Conversation

@quantskills-GuoYJ

@quantskills-GuoYJ quantskills-GuoYJ commented Aug 10, 2026

Copy link
Copy Markdown
Contributor

中文说明

本 PR 建立 QuantSkills 新目录体系的基础层:

  • 冻结 10 个一级分类、61 个二级分类、14 个量化研究与交易阶段
  • 新增目录声明 Schema v2、语义校验、双语简介规范及风险/宣传文案门禁
  • 提供 audit / enforce 两种迁移模式:旧项目保持可见,严格模式拒绝缺失、未知和回退值
  • 以显式清单锁定 158 个 Skill/Agent 与 4 个组织资源,防止 API 不完整时发布成功子集
  • 生成确定性完整快照和向后兼容的 registry.json 投影,并在发布前核验 Schema、snapshot ID、资产集合和 README 交叉引用
  • 增加失败回滚、双语契约文档、五运行时模板集成测试及安全的夜间扫描发布门禁

验证结果

  • Registry 单元与集成测试:51/51 通过
  • 当前旧目录 audit:103 项通过,并输出预期迁移告警
  • 完整 v2 fixture enforce:通过
  • Skill / Agent 模板:严格校验均为 healthy
  • Skill qsh-form:通过
  • 最终架构审查:0 Critical、0 Important

依赖与合并顺序

依赖:

请先合并两个模板 PR,再重新运行本 PR 的 Registry 集成检查,最后将本 PR 从 Draft 转为 Ready 并合并。

本基础层不包含 158 个项目的批量元数据迁移,也不会基于不完整声明发布根 catalog.snapshot.json。下一阶段将在 quantskills/quantskills 中实现 README 与网页同源的新导航。

English summary

Establish the catalog contract v2 foundation: frozen taxonomy, declaration and safety validation, audit/enforce migration modes, explicit closed inventory, deterministic snapshot generation, rollback-safe publication, bilingual contract documentation, and five-runtime template integration.

@quantskills-GuoYJ
quantskills-GuoYJ marked this pull request as ready for review August 10, 2026 09:28
@quantskills-GuoYJ
quantskills-GuoYJ merged commit cde4cc9 into main Aug 10, 2026
1 of 3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant