用途：审查 AI 指令配置文件本身的设计质量，包括 AGENTS.md、CLAUDE.md、CLAUDE.local.md、GEMINI.md 以及 .claude 下的 skills、agents、commands、hooks、settings.json。它不判断配置与项目状态是否同步，那属于文档同步工具的职责。
主要能力：提供三种模式。①审查诊断：按六维度逐项检查，定位到文件与行号，输出问题清单、改写建议和结论等级（优秀、基本可用、需要精简、需要重构、风险较高）。②新项目起草：先确认项目类型、目录结构和协作 AI 数量，再按根文件精简、子目录就近的原则产出骨架草稿。③最佳实践问答：直接给出结论、推荐结构和注意事项。
六维度：长度预算（逐行判断删掉后行为是否变化）、规则可执行性（能否被 AI 自查或用工具验证）、分区路由（根文件与子目录职责划分）、重复与矛盾、入口一致性（多入口是否漂移）、时效（引用的路径、命令是否仍存在）。
使用方式：审查模式需提供目标文件路径或全文；起草模式需提供项目类型、目录结构和协作 AI 数量；问答模式直接提问。模式由 Agent 自动判定，拿不准时先向用户确认。审查模式默认只读不改，只有用户明确要求优化或执行后才落地编辑，且只改被诊断出问题的部分。不凭空发明命令或路径，验证不了的内容标注为待确认。
安装：npx skills add soia-team/soia-open-dev-coding-skills -g -a '*' -s soia-dev-agent-md-advisor -y 配置路径：~/.config/soia-skills/soia-dev-agent-md-advisor/config.yml，或用环境变量 SOIA_DEV_AGENT_MD_ADVISOR_CONFIG_FILE 指定；当前版本不需要创建 config.yml。
适用场景：项目已有大量 AI 指令文件需要精简或重构、monorepo 需要拆分根文件与子目录规则、多入口需要统一真源、新项目需要配置骨架。
限制：不执行代码、不跑测试、不改业务逻辑，不读取账号、凭据或无关本机文件；不做跨文档状态对账与发布回填；价格与平台支持等信息暂未提供。