前言¶
看到一张喜欢的图,常见做法是去搜「类似色调 Lightroom 预设」或翻论坛帖猜光圈快门。图里没有 EXIF、或是截图和压缩图时,猜参往往对不上画面特征,调色也只能模仿表面。若希望 Agent 在上传照片后,按固定流程做视觉分析、参数推断和后期建议,需要一套写进 SKILL.md 的摄影指导技能,而不是每次从零写提示词。
下面介绍 SkillHub 上的 Photo Guide(坐标 @user_eec9ad28/photo-guide-skill,版本 1.0.0,社区来源,分类 design-media)。
这是什么¶
Photo Guide 是面向摄影新手的照片分析 Skill:用户上传图片并询问如何拍出类似效果、拍摄参数或后期调色时,由 Agent 按技能文档执行分析,输出结构化报告。
- 维护与发布:SkillHub 发布者为
user_eec9ad28;技能元数据标注作者为 dcison,遵循 AgentSkills 开放标准,主页为 https://github.com/dcison/photo-guide-skill。 - 解决的问题:在有无 EXIF 两种情况下,统一完成参数推断、风格对照、拍摄与后期建议,并强调「推断值」与「范围」而非假装精确读数。
- 依赖与标签:需具备图片分析能力;本地 EXIF 提取依赖 Python 3.10+ 与 Pillow(见包内
requirements.txt)。SkillHub 标签为requires_api_key=false,无需 API Key。
核心功能¶
以下能力均来自技能主文档 SKILL.md 与 README,安装后由 Agent 按工作流程调用。
- EXIF 提取:对本地文件运行
scripts/extract_exif.py,得到光圈、快门、ISO、焦距、相机型号等;有 EXIF 时作为校验基准,无 EXIF 则进入纯视觉推断。 - 五维视觉分析:从景深、动态、光影、色彩、构图推断参数,并对照
references/photography-basics.md中的参考表。 - 风格模板匹配:对照
references/style-templates.md(README 写明含 10 种常见风格)交叉验证推断结果。 - 结构化报告:画面概述、拍摄参数表(含推断理由)、技巧要点、可选优化建议、后期调色、拍摄模式/对焦/测光等设置、场景速查表;控光场景可含布光与道具建议;手机拍摄时可出替代方案与学习关键词。
- 后期细节:用户追问调色时,可查
references/post-processing-guide.md。 - 本地与隐私:文档说明分析在 Agent 本地完成,EXIF 脚本只读用户指定图片,不依赖外部密钥。
安装与启用¶
通过 SkillHub CLI(推荐)¶
先确认是否已安装 skillhub(完整说明见 SkillHub 安装文档):
command -v skillhub && skillhub --version
未安装时可执行官方安装脚本(需联网环境):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装技能时必须用 --dir 指向当前 Agent 的 skills 目录,否则默认装到 ./skills/ 可能不会被识别:
skillhub install @user_eec9ad28/photo-guide-skill --dir <你的 Agent skills 目录>
常用目录示例(以 SkillHub 安装文档为准):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或项目下的.agents/skills/
也可将下面提示词发给支持 Skill 的 AI,让其按安装文档完成安装:
请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_eec9ad28/photo-guide-skill`。
Python 依赖¶
Agent 执行技能时会按文档检查 Pillow;也可预先安装:
pip install -r requirements.txt
技能声明允许使用的工具为 Bash 与 Read,用于运行 EXIF 脚本和读取参考文档。
其他安装途径¶
README 提到可从 ClawHub 搜索 photo-guide-skill 安装,或手动复制/链接到 Agent 的 skills 目录。在 Cursor 等环境以 SkillHub 坐标安装即可与商店页一致。
典型用法¶
触发条件¶
需同时满足:提供图片(文件或链接),且明确要摄影指导,例如:
- 「这张照片怎么拍的?」
- 「教我拍出这种效果」
- 「这张照片的光圈/快门是多少?」
- 「怎么调这种色调?」
- 「帮我分析一下这张照片」
本地 EXIF(可选一步)¶
用户提供本地路径时,Agent 可执行:
python3 scripts/extract_exif.py <图片路径>
输出 JSON 中 has_exif: true 时,报告可增加「实际值」列与推断值对比;截图或网络图无 EXIF 属正常情况。
报告形态¶
经过上述步骤,输出为固定栏目的「照片分析报告」(概述、参数表、技巧、后期、机身设置、学习关键词等)。技能要求:无 EXIF 时标明为推测;参数用范围(如 f/2.0 - f/2.8);语气先肯定再建议;报告语言与用户提问一致。
README 中的海景长曝光示例展示了无 EXIF 时纯视觉推断的报告片段,可作为预期输出参考。
适用场景与注意¶
适合谁
- 摄影入门者:想从一张参考图反推「大概用了什么参数、该怎么设机身、后期往哪调」。
- 已在用 Cursor、Claude Code、OpenClaw 等支持 AgentSkills 的开发者:希望把摄影问答固化成可复用 Skill,而不是每次手写长提示。
限制与注意
- 参数多为推断,仅在有 EXIF 时部分字段可对照真实值;模糊图、视频截图会降低精度。
- 手机照片光圈往往不可调,技能文档要求建议中考虑手机局限。
- 视觉分析依赖当前 Agent 的多模态能力;EXIF 部分依赖本机 Python 环境。
- SkillHub 页面统计(截至资料抓取):评分 100000,下载 646,安装 13;与线索中的历史数字可能因时间不同而不一致,以商店页为准。
结尾¶
Photo Guide 把「看图 → EXIF(若有)→ 五维分析 → 风格校验 → 结构化报告」写进一套 SKILL.md 流程,适合上传参考图就问拍摄与后期的场景,且无需 API Key。官方 SkillHub 页面:https://www.skillhub.cn/skills/user_eec9ad28/photo-guide-skill;API 坐标入口:https://api.skillhub.cn/user_eec9ad28/photo-guide-skill。