新增 Live Photo 正式能力:单视频、二宫格、三宫格、四宫格、三连拼图、 长视频低成本诊断。增加 references/live-photo-production.md 生产规范、 scripts/ 工具链(contact sheet / .pvt 打包 / Apple metadata)、 validator R8 visual bounds + R9 title gap、文档约束测试。 由 Codex 完成主体实现。
2.1 KiB
2.1 KiB
Agent 工作约定
项目说明
这个目录是 guizang-social-card-skill 的 Skill 本体,用来给 Claude Code / Codex 等 Agent 提供"归藏风"社交图文生成能力。
它面向的产出包括:
- 小红书 / Rednote 3:4 图文组图。
- 微信公众号 21:9 头图 + 1:1 分享卡封面对。
- 文章封面、产品更新卡片、截图说明图、教程拆页等静态信息流视觉内容。
这个仓库的根目录应该保持为 Skill 可安装、可维护的结构。根目录主要放:
SKILL.mdREADME.md/README.en.mdreferences/assets/agents/validate-social-deck.mjspackage.json/package-lock.json- 授权、产品说明、交接等项目级文档
不要把一次性的生成案例、渲染输出、临时素材、调试脚本或下载图片直接放在 Skill 根目录。
测试产物放置规则
所有测试生成的产物都放到:
local-tests/
推荐按一次任务或一个测试案例建独立子目录:
local-tests/<case-name>/
每个测试目录可以包含自己的 index.html、render.cjs / render.mjs、assets/、output/、SOURCES.md 等文件。例如:
local-tests/social-card-example/
local-tests/social-card-example/index.html
local-tests/social-card-example/render.cjs
local-tests/social-card-example/assets/
local-tests/social-card-example/output/
原则:
- 试跑 HTML 放在
local-tests/<case-name>/。 - 渲染出来的 PNG/JPEG/WebP 放在
local-tests/<case-name>/output/。 - 下载或临时使用的图片、截图、素材放在
local-tests/<case-name>/assets/。 - 一次性调试脚本放在对应测试目录里;只有通用校验或 Skill 本体需要的脚本才放根目录。
- 如果要把某个测试案例升级为正式示例,先明确它属于项目文档、参考资料还是发布资产,再移动到合适位置;不要默认留在根目录。
local-tests/ 已在 .gitignore 中忽略,适合承载这些本地测试和生成产物。保持这个边界,能避免 Skill 本体再次混入大量一次性文件。