0 Fork 0

Files

T

郭浩andClaude 65720aa63e fix: v0.15 审查修复 — 文件名冲突、版本锁定、文档补全、降级路径

审查 Codex v0.15 后修复以下问题：

1. agent.md → AGENT.md：消除 macOS 大小写不敏感文件系统上的文件名冲突
2. HANDOFF.md：validator 规则数从"6 条"更正为"R1-R9"
3. makelive 版本锁定到 0.7.0（live-photo-production.md + package-live-photo.py）
4. 补充 Swift metadata helper 脚本的执行说明和依赖要求
5. platform-specs.md：将"Observed support"改为"截至 2026-07 实测"
6. SKILL.md：补充 GIF/MP4 降级路径，覆盖无法走 iPhone/AirDrop 的发布场景

由 Kiro (Claude Code) 完成审查和修复。

Co-Authored-By: Claude <noreply@anthropic.com>

2026-07-01 16:14:55 +08:00

2.1 KiB

Raw Blame History

Agent 工作约定

项目说明

这个目录是 guizang-social-card-skill 的 Skill 本体，用来给 Claude Code / Codex 等 Agent 提供"归藏风"社交图文生成能力。

它面向的产出包括：

小红书 / Rednote 3:4 图文组图。
微信公众号 21:9 头图 + 1:1 分享卡封面对。
文章封面、产品更新卡片、截图说明图、教程拆页等静态信息流视觉内容。

这个仓库的根目录应该保持为 Skill 可安装、可维护的结构。根目录主要放：

SKILL.md
README.md / README.en.md
references/
assets/
agents/
validate-social-deck.mjs
package.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 本体再次混入大量一次性文件。

2.1 KiB Raw Blame History

Agent 工作约定

项目说明

测试产物放置规则

2.1 KiB

Raw Blame History