soia-dev-agent-md-advisor

AGENTS.md / CLAUDE.md / GEMINI.md 以及 .claude/（skills / agents / commands / hooks / settings.json）的设计顾问——审查这些文件本身写得好不好、结构合不合理，不负责它们跟项目当前状态是否同步。三种模式：①审查现有配置（诊断）②为新项目起草配置骨架（起草）③最佳实践问答。

定位与边界

与 soia-dev-doc-sync 的分界

两个技能经常被同一句话触发，但关注对象完全不同，必须分清楚：

	本技能（soia-dev-agent-md-advisor）	soia-dev-doc-sync
关注对象	`AGENTS.md` / `CLAUDE.md` / `GEMINI.md` / `.claude/` 配置文件本身	`docs/`、`README*`、`CHANGELOG.md`、proposal 主文档、`board.md`
核心问题	这份配置文件写得好不好、该怎么设计、该不该拆分	这些文档跟真源（代码 / board / VERSION / proposal）是否一致
典型触发	"这个 AGENTS.md 太长了" "怎么拆分 CLAUDE.md" "多入口怎么管"	"docs 和提案文档有没有漂移" "release 后要不要回填文档"
输出	设计质量诊断 + 改写建议，或新骨架草稿	状态漂移清单 + 回填顺序
是否做跨文档状态对账	不做——"时效"维度只检查配置文件自身引用的路径/命令现在是否还存在，是一次性快照检查	专门做——按固定真源优先级跨文档核对状态、版本、命名是否一致

判断规则：用户在问"这份 AI 指令文件写得好不好 / 该怎么组织"，用本技能；用户在问"文档跟实际进度/版本是否对得上"，转 soia-dev-doc-sync。两者都命中时，先用本技能诊断配置文件设计问题，状态对齐问题转交 soia-dev-doc-sync，不要在本技能里代做。