---
name: photo-retouch
description: 摄影审片、选片与精修：单张诊断，或从一批照片按用途和主题精选、排序、统一观感，兼顾人物交付、旅行组图、商品目录、作品集和归档；用本地工具提供联系表、取舍理由、候选、批注精调、版本与顺序导出。可选文字点缀；视频执行需宿主另有工具。可结合宿主图片编辑按所需数量一次制作多图试片或 AI 综合精修成片；本地工具负责原片像素处理。
---

# 帧好 — 与你的 Agent 一起修片

审片与对话由当前宿主的视觉模型完成；本 Skill 的本地工具只在本机处理原片，不调用帧好服务或其他模型 API，也不需要模型 Key。向模型提供图像仍遵循宿主的数据与额度规则。

进入 AI 环节前，先检测当前会话实际可调用的生图/图片编辑工具及其图片输入能力，不通过生成测试图探测。工具不可用或不支持当前任务时，自动跳过 AI 环节，继续主题选片、原片精修与完整交付。可用且当前任务需要时，按 [AI多图试片与完整精修](references/generated-reference.md) 在主题与选片之后，按所需数量一次生成多格精修板，覆盖裁剪、光影、局部、质感与必要清理。逐格检查后，可用作原片精修参考，也可直接采用符合用途与像素要求的 AI 精修版本；不默认每张再调用一次。

## 知识导航

首次审片读审美判断，再按当前问题选题材或手段。只加载有关章节，不把全部知识塞进每次回答。以下是处理决策与检查标准，不能代替实际看图。

| 遇到什么任务 | 读取什么 |
| --- | --- |
| 更高级、诊断、是否需要修改、解释取舍 | [审美判断](references/aesthetic-judgment.md) |
| 审美知识是否够、反复不好看、相近候选取舍、大师参考校准 | [审美校准](references/aesthetic-calibration.md)，比较具体关系并记录收益与代价 |
| GPT Image、一次多图、九宫格试片、AI 综合精修 | [AI多图试片与完整精修](references/generated-reference.md)，按数量合成一板、逐格完整精修，再决定参考或成片交付 |
| 不好看、风格平庸、精致调色、试片取舍 | [光色定调与试片验收](references/look-development.md) |
| 自动精修、结构化诊断、独立复审、清理旧图层、项目交换 | [可追踪的审片与交付](references/reviewed-workflow.md) |
| 需要实际照片对照、识别过度处理、参考处理条件 | [视觉案例](references/visual-examples.md) |
| 审核成片、发现问题后返修、交付前复看 | [成片审核与返修](references/result-audit.md) |
| 一堆照片、主题、选片、连拍取舍、排序、统一交付 | [组图创作](references/collection-craft.md)；执行时读 [组图工具](references/collection-tools.md) |
| 朋友圈九宫格、主题先行、每张与排列都不好看 | 先读 [主题驱动的组图](references/theme-led-series.md)，再按组图工具执行 |
| 更漂亮、更精致，材质与局部充分打磨 | [精修的正向方法](references/finishing-craft.md) |
| 自定义滤镜、逐张适配或按摄影师姓名参考 | [自定义滤镜](references/custom-looks.md)；摄影师先查 [风格参考库](references/photographer-library.md) |
| 人像、风景、夜景、街头、建筑、静物、宠物等 | [题材策略](references/subject-playbooks.md) |
| 主次、留白、复杂场景、摄影练习 | [构图与拍摄](references/composition-craft.md) |
| 曝光、白平衡、肤色、曲线、HSL | [光线与色彩](references/light-color.md) |
| 复合请求、工具目录、区域或对象目标、可复用蒙版 | [工具组合](references/tool-composition.md) |
| 锐化/降噪、羽化/渐变、裁剪/拉直、导出 | [细节与局部工艺](references/detail-local-crop.md) |
| 大师参考、风格选择、强度与自适应 | [风格图谱](references/style-atlas.md) |
| 照片加字、可爱短句、贴纸标题、图文封面 | [文字点缀](references/lettering.md) |
| 视频色彩管理、镜头匹配、剪辑节奏和声音 | [视频工艺与能力分流](references/video-craft.md) |
| 接受/取消、偏好、知识沉淀与成长反馈 | [学习与记忆](references/learning-memory.md) |
| 类似案例、常见过度处理和反例 | [案例手册](references/casebook.md) |
| 作者、官方文档、工具事实与解释边界 | [来源](references/sources.md) |

也可用 `node <skill>/scripts/knowledge.mjs search --query <问题或作者名>` 找章节，再 `read --id <返回的id>`。这是本地关键词检索，未匹配时用上表；相关度不代表照片评分。`check` 可核对索引、真实风格和参数对应关系。

视频先按视频参考确认读取和执行能力；下面的本地照片流程不接受视频文件。仅看过抽帧时不得声称已审阅运动、声音或全片。

## 开始照片项目

把下文的 `<skill>` 替换为此 SKILL.md 所在目录，`<project>` 为照片项目目录。路径用宿主 shell 的正确引用方式传入，不拼接用户文字到可执行命令中。

1. 首次运行 `node <skill>/scripts/setup.mjs`，检查 Node 20.9+ 并安装此 Skill 的固定图片处理依赖。以后运行不会重复安装。
2. 新照片：`node <skill>/scripts/cli.mjs init --image <photo> --project <new-project-directory> --intent <表达目标>`。项目目录须不存在，父目录须存在。保留源图字节，不改动输入文件。
3. 已有项目：`node <skill>/scripts/cli.mjs inspect --project <project>`。读取 `revision`、当前版本、意图、全部批注、审片记录、候选和预览路径。
4. 用宿主实际的图片读取工具查看返回的原片/当前预览。不能仅凭文件名、均值或用户评论声称已识别画面。无视觉能力时明确说明，并提供基础统计或人工调参，不伪称视觉审片。

工具命令和 JSON 结构见 [工具参考](references/tools.md)，需要编写方案或局部操作时再读取。

## 一批照片的完整流程

多张输入先判断用户要“全部修好”还是“精选一组”，不能默认淘汰；按 [组图创作](references/collection-craft.md) 区分旅行分享、人物/活动交付、商品目录、作品集和归档。用途、主题和必留条件已经清楚就继续，只有缺失答案会改变取舍时才问一个具体问题。

创作型组图先快速了解素材，再在正式选片前形成主题方案：表达、观看感受、可见关系与纳入/退出依据。按 [主题驱动的组图](references/theme-led-series.md) 让它贯穿选片、逐张打磨与排列；题材清单或配色不能代替主题。主题由用户交给 Agent 决定时自行推进，不增加主题审批。单张吸引力与整组成立分别判断，不能用角色齐全、技术可用或审片一致赞同代替结果。

1. `collection-init` 保存整批原片和稳定 ID；查看逐个导入错误。`collection-sheet` 分页实际看图，再打开候选单图与细节。没有看过的照片明确保留为 unreviewed，工具统计不替代视觉判断。
2. 用 `collection-brief` 保存用途、主题、期望数量、必留 ID 与保护条件。`collection-plan` 保存 select/reserve/exclude、画面依据、角色和 order；源图不会删除。数量是期望，必要信息与情感价值优先，不为凑数补弱片。
3. 初选时试排以检查主题的缺口和重复，再按每张的亮点与表达阻碍充分精修；共同风格与逐张绝对目标分开，不跨图复制局部坐标，不强行统一昼夜亮度。查看真实修后版本再决定正式排列；时间线只用可靠信息，定调参考不必是封面。用户要求完整九张时，少量定调试片不能替代完整交付，也不能擅自收窄为同一题材。
4. 通过返回的单图项目路径进入下面的候选/批注/接受流程。接受新版本、更新主题或批注会使旧组选片过期；复看单张完整画面、关键细节和真实三行三列的九格，再以最新 snapshotHash 保存最终方案。单张或整组仍有表达阻碍时保留为试修；不能为导出把弱片问题全部降成 minor。
5. `collection-export` 按顺序导出已保存版本与 manifest；失败逐张保留并可重试。交付主题、已审阅范围、顺序、取舍理由和备选，供用户继续换图或精调。上传发布和删除照片需用户明确要求。

具体命令和 JSON 见 [组图工具](references/collection-tools.md)。批次最多 500 个文件，联系表每页 20 张；大批分段审阅。不把目前的几何蒙版称为语义选区，不把静态照片工具称为 RAW、视频或印刷排版工具。

## 可追踪的精修

自动精修、返修或正式交付时，读 [可追踪的审片与交付](references/reviewed-workflow.md)，启用 reviewed 流程；人手探索参数可以保持 manual。实际看当前图后记录 `diagnosis`，保存目标、值得保留的关系、具体位置、处理假设和检查点。工具返回当前阶段和下一步；零项问题可以保留原片。

光色判断缺少把握时，读相近 [视觉案例](references/visual-examples.md)，或用 `probe` 看当前照片上的真实参数响应。案例与测量辅助选择，不能替代视觉判断或直接套用配方。

反复被否定或需要独立判断时，准备 `review-packet`，按宿主可用且已授权的能力交给另一位审片者；不提供旧结论或希望得到的答案。区分 self/independent，缺少独立能力时如实自审。审核以 `resolutions` 回答原诊断，Agent 保存交付版须通过当前组合的审核。不要伪造审片者身份、靠 preserved 状态掩盖阻碍或把哈希当审美证明。

旧调整难以理清时先 `edit-sources`，用 `rebuild` 显式重建获准范围，再看试片；未指定范围保留。用户要在网页或自己的 Agent 继续时，用项目交换快照，先核对支持范围与实际导入结果。

## 审片与候选

- 先理解这一张的意图。表达含糊且会改变方向时，问一个具体问题；当前意图优先于既往选择。
- 从主体、背景、光线、构图、视觉秩序与情绪观察。区分可见依据、解释和不确定性，不把风格口味当成技术错误。
- 用户要求充分打磨时，按 [精修的正向方法](references/finishing-craft.md) 与主题给每张具体成片目标，再检查构图、光色、局部、材质、边缘和实际输出。主体变大、颜色自然、没有伪影都不是单独的审美过关依据；缺少可见吸引力时返修或换备选，不以更多参数代替结果。
- 风格任务先建立可指认的光色关系，按 [定调与试片验收](references/look-development.md) 在相同基础与构图下比较；裁剪单独取舍。不要把许多微调、工具成功或技术合格称为审美提升。
- 建议写成「画面位置与依据 → 对当前意图的影响 → 最小处理 → 检查点与代价」。先说明值得保留的关系，按真正有用的内容展开，不靠专业术语堆砌或固定条数显得全面。
- 可以没有调整。说明值得保留的关系；不机械提亮、增色或裁剪。必要时用 `review` 保存观察与保留依据，来源写作宿主 Agent，不编造另一个模型调用。
- 首次调参读 `controls`：范围与灰卡响应来自真实引擎。曝光是 EV；色温/色调为相对增益，不是 Lightroom 开尔文。统计值不证明主体曝光错误，剪切掉的高光无法恢复。
- `candidate` 的 `settings` 是当前手动层的**绝对目标值**，不是累加量。`style` 是独立风格层；不要再把其配方写进 settings。局部 settings 是该标记局部层的绝对目标；保留其他已接受的局部。
- 新方案优先用结构化 `items`：一项说明一个可独立取舍的改动，填写 `id`、`title`、`patch` 和可选 `dependsOn`。同一写入路径不要拆成两项。`selectedItemIds` 从固定基础版本重算，不在上次预览上累加。`tool-schema` 输出可交给宿主的函数工具定义，`tool --input` 仅分派允许的 JSON 操作；当前运行时仍不调用模型 API。
- 复合请求优先发现 `photo-tools` 目录，用 `compose` 的 `operations` 表达工具、目标、参数和依赖；每个被选中步骤在独立子进程执行，返回实际中间预览。见 [工具组合](references/tool-composition.md)。旧结构化 `items` 仍兼容，每项说明一个可独立取舍的 patch。`selectedItemIds` 始终从固定基础版本重算，不在上次预览上累加。`tool-schema` 输出可交给宿主的函数工具定义，`tool --input` 仅分派允许的 JSON 操作；运行时不调用模型 API。
- 每个方案填写刚读取的 `revision` 和 `baseVersion`。继续精调尚未接受的试片时，旧整组格式可填写 `fromCandidate`，继承所选试片的全部层并固化为相对已保存基础版本的一项；不要与 `items` 混用。用当前效果为基础，填写目标、主要取舍及自然易辨认的名称。候选不会改变当前版本。
- 查看候选实际预览，并用 `compare` 与基础版本共享范围对照。对眼睛、头发、肤色、高光与蒙版边缘，用 `preview --region --max-side 8192` 查看指定完整输出帧的准确裁片。region 不会重新渲染小区域；先核对返回的整帧尺寸、regionPixels 与 limited，不能无条件称为源图 100%。不能以工具执行成功、指标升高替代画质判断。
- 风格从当前光线和意图选择，解释成立条件与回退现象；大师名称是学习线索，不是官方配方。拍摄距离、时机、景深、长曝光等不能由调参补齐。精准参考要求实际看参考图。
- 用户交给 Agent 选择配色时，按 [中性基底与画面适配](references/light-color.md#中性基底与画面适配) 用光、材料和主辅色决定方向，不重复发风格问卷。被拒绝的多轮调色需核对所有全局、风格与局部来源；裁剪收益不能替代色彩验收。
- 按具体成片目标调整候选。有可见收益就继续打磨；几轮仍无收益时回到选片、构图或风格方向检查原因，必要时换备选。不把固定轮数作为审美过关或提前交付的理由，也不无限叠加无效处理；原片已成立时可保留。
- 被指出效果不足时，按 [成片审核与返修](references/result-audit.md) 从失败版开始检查构图、主次、光色及细节，记录 revise/reject 和具体下一步，再实际修改并复看。不能只新增文档或继续重复弱调色。
- 供用户预览后接受；若用户已明确授权自动完成修片，可自行接受经实际检查合格的方案。普通候选预览、比较与取消不需要重复审批。
- Agent 保存试修用于交付时，实际看图后写 `result-audit`，用 `accept --by agent --require-audit true` 核对同一组合的 ready 审核，不计为用户偏好。仍有阻碍问题时保留为未完成试修，不标作已通过。明确拒绝已保存版本时用 `feedback` 记录用户原话；后续参考 `preferenceChoices`，不要复用被拒绝版本的偏好结论。

## 与完整工作台共享项目

用户希望在完整帧好网页中继续时，运行 `node <skill>/scripts/cli.mjs studio --project <project>`，用宿主打开网页的工具展示返回的 `url`。本机需先在帧好仓库运行 `npm run setup` 和 `npm start`；CLI 不会自行安装或启动另一套服务。

网页与本 Skill 读写同一个 `project.json`，批注、候选选择、已保存版本和导出记录会同步。继续前仍须重新 `inspect`，使用最新 revision；网页有未同步修改时不要绕过冲突检查。网页预览不会自动接受候选。

开启诊断与复审、含文字或保护设置的项目会在完整工作台内进入“协作精修”，仍使用同一份项目和原生处理流程。也可用下面的 `serve` 独立预览。不要通过网页快照接口绕过诊断、复评或保护检查。

macOS 可直接 `init` 静态 HEIC/HEIF，工具用系统解码器生成 8 位工作图，保留原文件字节。其他系统仍需先转换；RAW/TIFF 仍需导出 JPEG/PNG。

## 接续请求与等待

网页的“交给 Agent 继续”保存真实接续请求。查看 `inspect` 返回的 `project.collaboration`：queued 是等待接手，running 是已由 Agent 领取，不代表运行时会自行调用模型。

1. 先 inspect 并看最新图与批注。用户要求处理网页接续时，用 `handoff --input` 提交 `{action:"claim", revision, id:<请求id>, actorId:<本宿主标识>}`。actorId 是宿主声明，不是认证身份。
2. 每次写入用最新 revision。用 `{action:"progress", revision, id, actorId, summary}` 报告实际进度。生成候选或 compose 时填写 `handoffId: id` 和同一个 actorId，避免取消后的旧工作再次提交。
3. 实际检查候选后，以 `{action:"complete", revision, id, actorId, summary, candidateIds:[<实际候选id>]}` 回应，留给用户比较。没有调整也可返回空列表并说明保留依据；complete 不等于接受、审核或偏好学习。失败用 action:"fail"，说明原因。
4. 用户取消、当前意图／批注变化，或 HANDOFF_STALE/HANDOFF_CLOSED 时停止旧接续；重新 inspect，保留用户修改，不盲目重试。正常的 reviewed 和成片审核规则仍适用。
5. 只有用户要求继续等待这个项目时，运行 `watch --project <project> --after-revision <刚读到的revision> --timeout 60`。它等待文件事件并返回 handoff、project-updated 或 timeout；收到事件后重新 inspect，处理已授权范围。不要声称仅启动 watch 就已开始审片，也不要在无人要求时无限等待。

完整 JSON 和取消方式见 [工具参考](references/tools.md#接续请求)。

## 用户精调与批注

`serve` 启动只监听 127.0.0.1 的本地预览。打开它返回的地址，用户可以看原片/候选对照、100%查看、平移、框选评论、设置保护范围、手动试片、接受/取消、恢复版本和导出。

对话继续在当前宿主中进行。页面没有独立模型服务，不能声称页面内自动发生 AI 对话。

- 用户说「看我刚标的地方」时重新 `inspect`，查看带编号原片、每处范围与评论，并优先回应其实际意图。
- 批注和局部蒙版分开保存：删除讨论标记不会悄悄删除已接受版本中的像素调整。
- 几何蒙版不等于语义分割。矩形或径向提亮可能影响背景；用羽化和实际对照检查过渡，不声称精准选中脸部或天空。
- 坐标属于正向原片，归一化到 0～1；裁剪与拉直不会改写原片批注坐标。工具参考中有示例。
- 用户改过照片、意图或批注后，旧候选会变为过期。重新读取和试片；不通过删批注、恢复旧版本或盲目复用旧参数绕开冲突。
- 参数锁同时固定手动值与风格后的有效值；局部层锁固定整层，均不等于锁住某块最终观感。`guards protect` 的画面保护引用已保存版本和独立原片坐标蒙版，最后合成硬核心，向选区外羽化；存在区域保护时先解除并接受预览，才能重新裁剪或拉直。旧批注 `protect` 仍仅防裁剪。
- 新增参数锁或画面保护保存一个不改像素的版本；解除操作生成试片，接受后才解除。恢复历史版本保留当前约束，冲突会拒绝；不通过恢复绕过锁。
- 接受前确认已检查的图和候选版本一致。页面有未提交参数时先生成试片或明确重置；预览失败先重试，不能把上一张画面当成最新效果。逐项候选必须提交最新 `revision` 和该组合预览的 `selectionHash`；全不选不产生新版本。用户明确取消时 `discard`；随时用 `restore` 回到命名版本。

## 文字点缀 · 可选模式

只有用户明确想在照片上加字时，才读取 [文字点缀](references/lettering.md)，使用独立 `lettering` 候选。普通审片和风格选择不加字，不把文字列入曝光、色彩等默认参数，也不按性别推断偏好。

先看当前成片的留白、主体与最新批注，再确定文案、字形、配色和位置。用户原话准确照用；短句、奶油贴纸和小标题都只是可选方向。文字层可继续精调、取消或移除，光色和原片保持独立；需要纯摄影成片时用 `export --without-text true`。

## 收尾

区域保护仅承诺同尺寸、同构图的最终 RGBA 核心一致。PNG 解码可逐字节验收，JPEG 只保证编码前一致。无字输出使用独立无字参考；管线/字体无法复现参考时停止保护输出，保留备份并显式解除后重新确认。

接受版用 `export` 导出，输出路径必须是新文件。验证实际尺寸，复看成片；若使用有损 JPEG，注意编码后的颜色和细节变化。

需要跨项目记忆时，经用户要求用 `profile-init/read/learn/edit` 建立可携带本地档案，记录题材、光线和具体理由；参考匹配条件，允许查看、修改与删除，不把单次选择泛化成永久口味。详见 [学习与记忆](references/learning-memory.md)。

个人选择从用户明确接受或 prefer 记录，不把 Agent 试修、审核 ready、浏览和取消当成偏好。后续建议参考 `preferenceChoices`，当前意图始终优先。跨项目档案需明确建立与学习，不会后台自动训练模型。

有价值的反馈保留「条件、意图、可见依据、实际处理、接受/回退原因、适用边界」。新增通用知识要有复现和反例，单张案例保持案例结论；个人档案只在用户要求时建立。

交付成片与项目位置，简要说明实际变化、保留与取舍。不宣称未经验证的摄影质量、RAW、16位色彩或自动分割能力。

服务用当前运行终端停止。进程意外关闭后重新 `serve` 同一项目即可继续；编辑保存在 project.json，API/会话令牌不写入编辑记录。没有用户要求持续预览时，完成后停止自己启动的服务。