soia-dev-agent-md-advisor

本技能是 AI 项目指令配置文件的设计顾问，处理 AGENTS.md、CLAUDE.md、GEMINI.md 以及 .claude/（skills/agents/commands/hooks/settings.json）本身写得好不好、结构是否合理，不负责这些文件与项目当前状态是否同步。提供三种模式：①审查（诊断），按长度预算、规则可执行性、分区路由、重复与矛盾、入口一致性、时效六个维度逐项检查，输出定位到文件:行的问题清单、改写建议与结论等级（优秀/基本可用/需要精简/需要重构/风险较高），默认只诊断不改文件；②起草，先确认项目类型、目录结构与协作 AI 数量，按“根文件精简+子目录就近”输出骨架草稿，命令须来自可验证来源，否则标注占位待确认；③问答，直接给出结论、推荐结构与注意事项。审查输入为目标文件路径或全文，起草输入为项目类型、目录结构、协作 AI 数量，问答只需提问。模式判定由 Agent 自动进行，无法判定时先询问用户。安装方式：claude plugin marketplace add soia-team/soia-open-skills 与 claude plugin install soia-dev@soia；仅装本技能可用 npx skills add soia-team/soia-open-dev-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。限制：不执行代码、不跑测试、不改业务逻辑；默认只读不改文件，仅客户明确要求后才落地编辑且只改诊断出问题的部分；不凭空发明命令或路径；不默认建议上马复杂配置全家桶；不读取账号、凭据或无关文件；与 soia-dev-doc-sync 分工不同，不做跨文档状态对账。