野生码农
GitHub 调研:agent 配置领域 + 本地配置体系审计
随叫调研。触发:本人对 ipdev 产线改造的配置描述不满意,要求研究"军师如何专业做配置"。 数据口径:star 数来自
gh api实时查询(2026-09-06);30 天增长来自 trendshift.io 内嵌日粒度数据(窗口 2026-08-07~09-06);标"未获取"处为 trendshift ID 未定位,未编造。
〇、结论先行
- 行业已收敛出三层配置原子:AGENTS.md(纪律层,跨工具标准)+ SKILL.md(能力层,正跨工具化)+ subagent 岗位定义(待收敛)。本项目"纪律进章程、能力进技能、渐进披露"的方向与主流一致,不用推翻。
- 本地真正的短板不在"不懂规范",在缺生产工序:从"要配一个 agent"到"配置合格投产"之间没有 SOP、没有内容质量评审清单、没有样例库;官方现成方法论(design-agent/design-task 技能,1204 行)闲置零引用。
- 昨天 ipdev 改造翻车的规则根源:违反自定的"事故驱动添加"原则——09-06 当天从千问套件整章翻译预写 6 组规则,全部 ⏳ 未验证,无一条对应翻车台账。
- MCP 缺两口:GitHub MCP(github-diaoyan 每周用手撸 gh api)和 SQLite MCP(kb.db/ip.db 是核心资产只能走脚本);opencode.json 零 MCP;playwright-crawler 双份配置漂移。
一、规范层对比(四大指令文件体系)
| 规范 | 机制 | 现状 |
|---|---|---|
| AGENTS.md | 仓库根纯 Markdown,支持子目录嵌套就近覆盖 | 已成跨工具事实标准:官网称 60,000+ 项目采用,Codex/Copilot/Cursor/Jules/Gemini/Amp 均读取;Linux 基金会托管;已有学术研究(arXiv 2601.20404、2602.14690) |
| CLAUDE.md+Skills+Subagents | 分层加载+@path 导入;SKILL.md 渐进披露 |
CLAUDE.md 仍私有;SKILL.md 正跨工具化:Codex 兼容、VS Code Copilot 1.108+ 原生支持、Gemini CLI 经 .agents/skills/ 加载 |
| Cursor rules | .mdc frontmatter 按 glob 条件挂载 |
机制最先进但格式私有;用户正向 AGENTS.md+skills 迁移 |
| Aider conventions | CONVENTIONS.md 常驻上下文 | 无标准,生态最弱 |
二、热门仓库清单(12 个,2026-09-06 实时数据)
规范本体与官方资源
| 项目 | star | 定位与亮点 |
|---|---|---|
| agentsmd/agents.md | 24,160 | AGENTS.md 规范本体;极简设计+全厂商背书 |
| anthropics/skills | 174,610 | SKILL.md 格式事实标准定义处;一年不到 17 万星,本领域增速最猛官方仓 |
| anthropics/claude-code | 144,190 | CLAUDE.md/skills/subagents 体系源头文档 |
Skills / Subagents 集合
| 项目 | star | 定位与亮点 |
|---|---|---|
| ComposioHQ/awesome-claude-skills | 74,548 | 社区最大技能策展;11 个月 7.4 万星,技能包已成独立流通资产 |
| wshobson/agents | 39,449 | 多 harness 插件市场:同一套子代理/技能同时适配 Claude Code/Codex/Cursor/OpenCode/Copilot CLI——"一次定义、多工具分发"2026 新范式 |
| VoltAgent/awesome-agent-skills | 33,796 | 1000+ 技能,明确跨工具兼容 |
| VoltAgent/awesome-claude-code-subagents | 24,881 | 100+ 专职子代理岗位定义,agent 岗位化最大素材库,frontmatter 写法可直接借鉴 |
| hesreallyhim/awesome-claude-code | 53,572 | Claude 生态总索引,策展较严 |
| github/awesome-copilot | 38,674 | GitHub 官方:instructions/AGENTS.md/SKILL.md 三种配置单元同仓,观察微软系规范的最佳样本 |
| PatrickJS/awesome-cursorrules | 40,732 | 2026-05 后停更,与 Cursor 用户转向 AGENTS.md 趋势一致 |
MCP 生态与提示词仓
| 项目 | star | 定位与亮点 |
|---|---|---|
| punkpeye/awesome-mcp-servers | 94,349 | 社区最大 MCP server 清单 |
| modelcontextprotocol/servers | 90,104 | MCP 官方参考 server 集 |
| modelcontextprotocol/registry | 7,224 | MCP 官方注册中心——生态从清单仓走向注册中心,基础设施化信号 |
| x1xhlol/system-prompts-and-models-of-ai-tools | 143,385(+760/30天) | 30+ 一线工具生产级系统提示词合集,写 agent 指令的最好教科书 |
| Shubhamsaboo/awesome-llm-apps | 136,261(+5,172/30天) | 100+ 可运行 agent 工程样例;日增 167 星 vs 提示词仓日增 25 星——社区从"抄提示词"转向"可运行样例" |
三、本地体系审计:八条短板(证据见各文件)
- 章程只立纪律无方法论:AGENTS.md 军师亲手职责只列"做什么"(岗位设计/yaml/闸门),全文无一条"怎么做";方法论散落两处均不够用(writing-standard §三仅 6 条单行规则;crewai 技能偏参数手册)。
- 官方方法论闲置:用户级技能 design-agent(700 行)/design-task(504 行)正是"怎么写 role/goal/backstory、怎么写任务描述与验收标准"的官方答案,grep 确认全仓库零引用。
- 配置生产无 SOP:发布物有完整 SOP(发布工具链SOP.md 145 行),配置生产没有——无内容质量评审清单、无"好配置 vs 翻车配置"对照样例库、团队模板只是 24 行空壳。
- 三禁被最高章程带头违反:AGENTS.md 正文第 3/27/28/32/98/105 行多处日期流水账与裁定出处;ceshi/github-diaoyan/tuandui 技能同样带"立档日期+本人裁定"。规范存在但无日常自检闸。
- 事故驱动原则被 09-06 改造系统性违反:ipdev rules.md 当天连增三轮规则,来源全是"千问套件精读提取",全部 ⏳ 未验证、无翻车台账编号——外部材料→配置缺"蒸馏"工序,要么几句摘要(太浅),要么整章翻译(预写)。
- 口号式写作无尺可量:ipdev/agents.yaml backstory 含"信条是'最简单的能跑的方案'"(:34)、"DB 是唯一事实源"(:88)等动机式表述;规范只说"具体>口号"却不给正反例库。
- 配置双轨漂移是复发模式:launcher.py 模板与双稿制冲突(08-27)、output/team 旧人格 vs CrewAI yaml(隐患#3)、zdq 双章程(隐患#5)、playwright-crawler 双份配置——registry 只登记风险,无单一来源强制约定。
- 技能无生命周期管理:无"何时蒸馏成技能、怎么验收、怎么退役"的成文流程;ai-dev-blog 超行数预算 64% 至今未拆;tuandui 仍指向旧体系人格文档。
四、改造建议(报本人确认后执行)
4.1 AGENTS.md 怎么改(小改,不推翻)
- 正文只加一行指针:军师亲手职责节末加"配置操作手册:
docs/agent-config-sop.md(新建/改造/评审 agent 配置时必查)"——符合渐进披露,不把方法论塞进章程。 - 顺手自清三禁:正文 6 处日期流水账/裁定出处迁移到 config-ledger,正文只留规则本身。
4.2 新建 docs/agent-config-sop.md(核心交付物)
配置生产五道工序:
- 定岗位:先查官方方法论(design-agent/design-task 技能)+ 生产级样例(x1xhlol 提示词仓、VoltAgent subagents 仓),禁止凭空写 role/goal/backstory;
- 写配置:对照评审清单逐项自检(清单从 writing-standard §三 6 条扩为可打勾条目:role 是否领域+级别/goal 是否可检验/backstory 是否零口号/任务描述是否含编号化验收要素/guardrail 是否挂载);
- 小剂量入库:外部材料蒸馏铁律——提取→对齐自身翻车证据→小剂量入配置→真跑验证→再扩;一次引入未验证规则 ≤3 条,条 ⏳ 超 14 天未回填自动点名;
- 双轨检查:改动涉及的事实是否有第二处拷贝(模板/人格文档/双章程/双 MCP 配置),有则声明单一来源;
- 投产验收:走现有 audit_crews.py 四步 + 新增语义层抽查(观测口径/引用可见性/scope 完整性——对应短板 7 的三起潜伏 bug 类型)。
4.3 技能蒸馏流程(补技能生命周期)
写入 writing-standard:技能创建准入(同一类活第 2 次翻车或第 3 次重跑即立项)→ 实战验证(至少 1 次真跑留证据)→ 行数预算内交付 → 超预算立项拆分 → 退役进 _archive。
4.4 MCP 补齐(优先级排序)
- SQLite MCP(P1):kb.db/data/ip.db 是核心资产,官方 servers 仓有 sqlite 参考实现;
- GitHub MCP(P1):github-diaoyan 每周例行调研专用,官方 server 现成;
- 修复 playwright-crawler 双份配置漂移(P1):用户级改指项目级锁定路径;
- opencode.json 按需(P2)。
五、主线对齐评估与 Top 3
- anthropics/skills:值得深入。本项目技能体系就是 SKILL.md 格式,官方仓 17 万星的参考实现直接是教科书。最小动作:抽 3 个官方技能对照本地技能找写法差距,沉淀进 writing-standard。
- VoltAgent/awesome-claude-code-subagents:值得深入。100+ 岗位定义是 ipdev/yinliu 产线 role/goal/backstory 的直接样例库。最小动作:挑 5 个与 pm/qa/写手同构的岗位,对比写进样例库(好配置 vs 翻车配置对照)。
- modelcontextprotocol/registry:收藏备用。MCP 挂载已变声明式依赖,按 4.4 补两个 server 即可,不必深挖生态。
- 路过:awesome-cursorrules(停更,私有格式夕阳)、awesome-llm-apps(工程样例与配置主线弱相关)、awesome-copilot(微软系,本机不用)。
六、趋势判断
- AGENTS.md 已赢下项目级指令文件之战,再写私有单工具配置=技术债;
- SKILL.md 正复制 AGENTS.md 的跨工具路径,本项目"纪律+技能两层"押对了;
- 子代理岗位定义是下一个待收敛点,现在投资样例库正当时;
- MCP 进入基础设施化,发现/治理取代供给成为瓶颈——对本项目意味着"装 server"不再是调研课题,是例行配置;
- 社区注意力从抄提示词转向可运行样例与技能包——个人 IP 侧可做"agent 配置实战"内容素材(测评/教程向)。