菜单
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 提供项目上下文。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| 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 只留给少数关键约束完成后说明改了什么，并建议用户实际跑一次常见任务来验证。
根据用户描述和项目上下文生成文件。信息不足时先创建保守的最小可用版本，不要臆造复杂规则。
创建时优先包含：
文章解读助手。对用户提供的文章（URL、Markdown、PDF、粘贴文本）进行结构化解读，输出包含总览、关键要点、个人启发、批判性思考和延伸思考的 Markdown 报告。触发词：文章解读、解读文章、帮我解读、读一下这篇、分析这篇文章、article interpretation。
去除 AI 味道的文章风格优化技能。用于识别并改写文章、公众号稿、自媒体稿、口播稿、演讲稿、课程稿、产品文案中的 AI 痕迹、模板腔、资料味、翻译腔、内容空心、空洞大词、过度金句、破折号滥用、bullet 堆叠、动不动加粗等问题；当用户说“去 AI 味”“去除 AI 痕迹”“不像 AI 写的”“更像人写的”“更自然”“别太机器味”“去掉模板感”“改得像公众号终稿”时使用。不用于事实核查、从零选题策划、论文转公众号、纯标题生成或追求 AI 检测器通过率。
First-tier tech company P7 capability advisor for evaluating, coaching, and giving career advice against a P7 technical/product/expert profile. Use when the user asks for P7-level assessment, promotion readiness, capability gaps, resume/project review, interview preparation, or concrete growth advice based on first-tier tech company P7 expectations.
First-tier tech company P8 capability advisor for evaluating, coaching, and giving career advice against a P8 senior expert, architect, or domain-owner profile. Use when the user asks for P8-level assessment, promotion readiness, capability gaps, project or resume review, interview preparation, or growth advice based on first-tier tech company P8 expectations.
First-tier tech company P9 capability advisor for evaluating, coaching, and giving career advice against a P9 senior expert, director, or business/organization-level leader profile. Use when the user asks for P9-level assessment, promotion readiness, executive capability gaps, strategic project review, resume positioning, interview preparation, or growth advice based on first-tier tech company P9 expectations.
微信公众号关注二维码生成助手。当用户要根据公众号 ID、微信号、原始 ID 或 `gh_...` 生成公众号二维码、下载成本地图片并在 Agent/Codex 聊天里显示，或不知道如何在微信里找到公众号 ID、需要操作引导图时使用此技能。只适用于微信公众号二维码，不用于小程序码、个人微信二维码或企业微信二维码。