agent-md-advisor

Installation
SKILL.md

Agent Markdown Advisor

帮助用户回答、审查、优化和创建 AI coding agent 指令文件,重点覆盖 AGENTS.mdCLAUDE.md

设计模式

本 skill 主要采用:

  • Advisor:回答格式、结构、放什么/不放什么等最佳实践问题
  • Reviewer:诊断已有 AGENTS.md / CLAUDE.md 是否违反最佳实践
  • Generator:根据项目和用户描述创建新的指令文件
  • Editor:用户明确要求执行优化时,直接修改相关文件

Gotchas

  • 不要把 AGENTS.md / CLAUDE.md 写成项目百科、README 复制品或完整 API 文档
  • 不要把 AGENTS.md / CLAUDE.md 写成人设说明书、口号墙或愿望清单;它应该像给资深工程师的技术简报
  • 不要把 linter、formatter、类型检查器能确定执行的规则改写成大量自然语言
  • 不要写实际密钥、token、生产连接串、客户数据或内部安全细节;只写密钥位置和访问方式
  • 不要凭空发明命令;先看 package.jsonpyproject.tomlMakefile、CI workflow、README 等可验证来源
Related skills

More from chujianyun/skills

Installs
15
GitHub Stars
570
First Seen
13 days ago