// AGENTS.md / CLAUDE.md 最佳实践顾问。用于用户询问 agents markdown、AGENTS.md、CLAUDE.md、Claude Code memory、AI coding agent 指令文件的格式、结构、最佳实践；也用于审查、诊断、重写、优化或从零创建 AGENTS.md、CLAUDE.md、CLAUDE.local.md、.claude/rules 等 agent 指令文件。不适用于通用 README 写作，除非目标是给 AI coding agent 提供项目上下文。
| name | agent-md-advisor |
| description | AGENTS.md / CLAUDE.md 最佳实践顾问。用于用户询问 agents markdown、AGENTS.md、CLAUDE.md、Claude Code memory、AI coding agent 指令文件的格式、结构、最佳实践；也用于审查、诊断、重写、优化或从零创建 AGENTS.md、CLAUDE.md、CLAUDE.local.md、.claude/rules 等 agent 指令文件。不适用于通用 README 写作，除非目标是给 AI coding agent 提供项目上下文。 |
帮助用户回答、审查、优化和创建 AI coding agent 指令文件，重点覆盖 AGENTS.md 与 CLAUDE.md。
本 skill 主要采用：
AGENTS.md / CLAUDE.md 是否违反最佳实践AGENTS.md / CLAUDE.md 写成项目百科、README 复制品或完整 API 文档AGENTS.md / CLAUDE.md 写成人设说明书、口号墙或愿望清单；它应该像给资深工程师的技术简报package.json、pyproject.toml、Makefile、CI workflow、README 等可验证来源.claude/agents、hooks、MCP、skills；先判断项目是否真的需要AGENTS.md 理想上 150 行以内，CLAUDE.md 优先压到 80-120 行，超过 200 行要强烈考虑拆分先判断用户需求属于哪一类：
AGENTS.md / CLAUDE.md。复制此清单并跟踪进度：
处理进度：
- [ ] 步骤 1：识别模式和目标文件
- [ ] 步骤 2：读取必要参考资料
- [ ] 步骤 3：读取项目上下文或用户提供内容
- [ ] 步骤 4：给出诊断、方案或草稿
- [ ] 步骤 5：如用户要求落地，修改文件并验证
优先判断目标：
AGENTS.mdCLAUDE.mdAGENTS.md / CLAUDE.mdCLAUDE.local.md 或用户级 memory，不要提交到团队共享文件如果用户没有指定文件名：
AGENTS.mdCLAUDE.mdAGENTS.md 为主，并视工具支持情况用 CLAUDE.md 或符号链接兼容诊断或创建文件前，先读取最小必要上下文：
AGENTS.md、CLAUDE.md、CLAUDE.local.mdREADME.mdpackage.json、pyproject.toml、Makefile、justfile、Taskfile.yml、pnpm-workspace.yaml.github/workflows/、pytest.ini、vitest.config.*、tsconfig.json.claude/、.cursor/rules/、.github/copilot-instructions.md只读与判断有关的文件。不要为了写指令文件而扫描整个仓库。
用简洁中文回答，并给出可操作判断：
结论：...
推荐结构：
- ...
注意事项：
- ...
必须明确给结论和优先级：
# Agent 指令文件诊断
结论：优秀 / 基本可用 / 需要重构 / 风险较高
成熟度：L0-L6 中的某一级
## 主要问题
1. [P1] ...
2. [P2] ...
## 做得好的地方
- ...
## 优化建议
1. ...
2. ...
## 建议改法
- 保留：...
- 删除：...
- 拆分：...
- 新增：...
如果能定位具体行，引用文件路径和行号。问题要围绕“会不会让 agent 更可靠”判断，不要只做文字润色。
先快速诊断，再直接编辑。编辑原则：
MUST / MUST NOT 只留给少数关键约束完成后说明改了什么，并建议用户实际跑一次常见任务来验证。
根据用户描述和项目上下文生成文件。信息不足时先创建保守的最小可用版本，不要臆造复杂规则。
创建时优先包含：
喔图(alltuu.com)云摄影相册批量下载工具。当用户需要从 alltuu.com / m.alltuu.com 相册批量下载原图时使用此技能。支持下载原图（6720x4480 级别），自动处理签名URL，并发下载。适用于 alltuu.com/album/ 相册链接。
PhotoPlus相册批量下载原图工具。当用户需要从 photoplus.cn/live/ 相册批量下载原图时使用此技能。适用于 photoplus.cn 相册链接，支持多线程并发、自动跳过已下载文件。
去除 AI 味道的文章风格优化技能。用于识别并改写文章、公众号稿、自媒体稿、口播稿、演讲稿、课程稿、产品文案中的 AI 痕迹、模板腔、资料味、翻译腔、空洞大词、过度金句、破折号滥用、bullet 堆叠、动不动加粗等问题；当用户说“去 AI 味”“去除 AI 痕迹”“不像 AI 写的”“更像人写的”“更自然”“别太机器味”“去掉模板感”“改得像公众号终稿”时使用。不用于事实核查、从零选题策划、论文转公众号、纯标题生成或追求 AI 检测器通过率。
审查并优化现有 skill 的触发语义、工作流、确认门槛、资源组织、安全边界与文档分层。当用户提到“优化 skill”“检查 skill 质量”“改进某个 skill”“重构技能说明”，或明确说明要优化哪些方面时使用。默认先审查并给计划，只有在用户明确确认开始修改后才实施。
GitHub 源码解读助手。适用于用户提供 GitHub 仓库链接，并希望解读源码、理解原理、分析架构、生成学习报告或快速上手文档时使用。会在 working 目录下生成源码解读和快速上手两份文档。默认先交付初稿，不自动复查；如果用户明确同意，再安排后续复查。不适用于仅克隆仓库或只要一句简介的场景。
当用户想在 Hermes Agent 正式版 main 分支上补充 QQ platform 支持，或明确提到“给 hermes main 增加 QQ 渠道”“把 QQ support 作为 skill 安装到 Hermes”“让正式版 Hermes 支持 QQ 和文件发送”时使用。这个技能会把当前仓库补成支持 QQ Bot、QQ 文件发送、QQ 平台配置和工具集接线的版本。