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>
This commit is contained in:
郭浩andClaude committed 2026-07-01 16:14:55 +08:00
1 parent f492caeb8b
commit 65720aa63e
6 files changed
+27 -6

No files matched your search

+21 -1
View File
@@ -209,9 +209,11 @@ Why this tool:
Install or run with `uv`:
```bash
uvx makelive IMG_TEST_LIVE.JPG IMG_TEST_LIVE.MOV
uvx --from 'makelive==0.7.0' makelive IMG_TEST_LIVE.JPG IMG_TEST_LIVE.MOV
```
Pin the version (`0.7.0` as of 2026-07) to avoid breakage from API changes in this small-audience package.
For `.pvt`, use the Python API:
```bash
@@ -236,6 +238,24 @@ uvx --from makelive python scripts/package-live-photo.py IMG_TEST_LIVE.JPG IMG_T
Use this wrapper when available so every run prints the asset id and `.pvt` path consistently.
### Swift Metadata Helpers
When `makelive` is unavailable or you need to add Apple Live Photo metadata manually, the repo includes two Swift scripts. They require macOS with the system Swift toolchain (Xcode or Command Line Tools) and AVFoundation.
Write the MakerNote asset identifier into a JPEG:
```bash
swift scripts/add-livephoto-maker-note.swift input.jpg output.jpg <asset-id>
```
Write the QuickTime content identifier and still-image-time metadata into a MOV:
```bash
swift scripts/add-livephoto-mov-metadata.swift input.mov output.mov <asset-id>
```
Both scripts must receive the same `<asset-id>` (a UUID string) so iPhone Photos pairs the JPG and MOV as one Live Photo. Normally `makelive` handles this automatically; the Swift scripts are a fallback for environments where Python/uvx is blocked.
## Intake Decision Tree
When the user provides video assets:
+3 -3
View File
@@ -112,10 +112,10 @@ output/wechat-cover-pair-preview.png
## WeChat Official Account Article Live Photo
Observed support is upload-path dependent:
截至 2026-07 实测,Live Photo 支持与上传路径相关:
- iPhone upload can preserve Live Photo in Official Account article editing.
- Web upload does not expose the same Live Photo path.
- iPhone 端上传可在公众号文章编辑中保留 Live Photo。
- 网页端上传没有对应的 Live Photo 入口。
- Keep Live Photo duration at or below `3s`.
- Publish path: AirDrop the `.pvt` package as one item to iPhone, then upload from the iPhone Official Account article editing path.