郭浩andClaude
65720aa63e
审查 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>
59 lines
2.1 KiB
Markdown
59 lines
2.1 KiB
Markdown
# 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 根目录。
|
|
|
|
## 测试产物放置规则
|
|
|
|
所有测试生成的产物都放到：
|
|
|
|
```text
|
|
local-tests/
|
|
```
|
|
|
|
推荐按一次任务或一个测试案例建独立子目录：
|
|
|
|
```text
|
|
local-tests/<case-name>/
|
|
```
|
|
|
|
每个测试目录可以包含自己的 `index.html`、`render.cjs` / `render.mjs`、`assets/`、`output/`、`SOURCES.md` 等文件。例如：
|
|
|
|
```text
|
|
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 本体再次混入大量一次性文件。
|