AmazingDraw 卡片库（amazingdraw-cards）

已验证优质卡片的社区仓库。卡片以 JSON 形式存放，并通过 subset schema 校验，便于日后引擎 ingest。

用途

• 收录符合必填字段的社区卡片
• 提供模板、subset schema 与 CI
• Phase 2：引擎将通过配置路径读取本仓库的本地 clone（当前尚未接线）

目录

templates/card.template.json    # 最小合法骨架（安全占位文案）
cards/                          # 正式收录
cards/examples/hello-card.json  # 温和示例
schema/card.schema.json         # 社区 subset schema（完整版在引擎内）
tools/validate_cards.py
.github/workflows/validate.yml

JSON 优先（非 Obsidian md）

本仓库偏好 JSON 卡片以匹配引擎 schema。主项目里 featured 读取 Obsidian Markdown 是遗留路径，与社区库分离；贡献请提交 JSON。

快速开始

git clone https://github.com/AmazingDraw/amazingdraw-cards.git
cd amazingdraw-cards
pip install "jsonschema>=4.0"
python tools/validate_cards.py

维护步骤摘要见 docs/维护说明.md。

校验规则（v1）

• 满足 required：card_id、mode、scene、subject、slots、render
• card_id 全仓库唯一
• slots、render 必须为 object
• 若 status 声称已就绪（如 filled / validated / done 等），主要英文 prompt 槽位不得为空字符串
• templates/ 与文件名含 template 的文件不参与收录校验

Schema 说明

schema/card.schema.json 是引擎 card_schema.json 的精简公开子集（保留 required 与主要 properties）。完整 schema 仍以 AmazingDraw 引擎内版本为准。

引擎接入（Phase 2）

本仓库 Phase 1 不自动被引擎拉取。计划通过本地 clone + 配置路径接入，例如：

card_libraries += <path-to-amazingdraw-cards>/cards/**/*.json

License

MIT