本文由 AI 智能体协助撰写与发布 | 内容经人工审核确认，观点归属作者本人。
更新日期：2026年7月10日
1. Demo 简介
是什么：一套基于 AGENTS.md 开放标准的 AI 智能体协作规范体系（开源仓库 + 交互式 HTML 导航页），包含 7 个角色定义、5 项协作协议、237+ 个可复用方法论模式（含 5 个 L3 标准化模式）、15 个 Skills（L0/L1/L2 三层架构）、59 个 Wiki 教程（8 大主题）、10+ 个自动化验证脚本。
面向谁：AI 开发团队（5-20 人规模）、个人 AI 重度用户、智能体开发者与运营者、AI 工程化研究者。
核心功能：
- 四层闭环架构：感知层（洞察+复盘）→ 认知层（萃取+进化）→ 执行层（迭代+验证）→ 治理层（管理+发展），让 AI 协作从随机对话变为有序工程
- AGENTS.md 启动协议：每次新对话自动加载角色定义和协作规范，AI 启动即理解项目架构，无需重复解释背景
- 四层质量防御体系：L0 模板字段层 → L1 任务执行层 → L2 子代理验收层 → L3 提交门禁层，关键规范点多层纵深防御，单点失效不导致整体失效
- L3 模式成熟度标准化：5 个 L3 标准化模式（入口+容器二元架构、三层治理闭环、Spec 驱动开发、四不外部依赖原则、元文档杠杆效应），将知识从"文档"转化为"执行门禁"
- 渐进式披露 Skills 体系：15 个 Skills 按 L0（入口速查）→ L1（门面索引）→ L2（完整规范）三层架构组织，按需加载避免上下文爆炸
- CI 验证流水线：10+ 项自动化检查覆盖 Git 忽略规则、链接有效性、规格一致性、模式成熟度、文件名规范、导航表更新等，确保规范体系自身质量可量化
量化产出：1,256 次 Git 提交 → 237+ 个可复用方法论模式（5 个 L3 标准化）+ 140+ 份复盘报告（10 个主题分类）+ 59 个 Wiki 教程（8 大主题）+ 15 个 Skills + 155+ 个 Python 脚本（核心脚本零第三方依赖）+ 456+ 个单元测试 + 5+ 个外部验证项目
2. Demo 创作思路
灵感来源：不是"灵光一现"——是在 TRAE 中进行了大量协作对话后，注意到一个可复现的模式：有明确规范前缀的对话，AI 产出质量显著高于无规范的对话。于是开始系统化这个发现：从单条规则 → 规则集合 → 角色分工体系 → 四层架构的方法论闭环。Community Live #13 中 TRAE 产品经理介绍的 Rules 特性给了关键启发——TRAE 原生支持规则配置，SpecWeave 将"零散的规则列表"系统化为"四层架构的完整工程体系"。
想解决的问题：当 AI 能胜任多种角色时，如何确保它在 100 次对话中始终理解你的意图？当前行业缺乏的不是"如何让 AI 做一件事"，而是"如何让 AI 在持续协作中保持上下文一致性、角色清晰性和产出质量可预测性"。
为什么做这个方向：大赛官网 30+ 灵感示例均为 C 端应用，没有任何一个涉及"如何更好地使用 TRAE 本身"——这是一个被所有人忽略的维度。SpecWeave 不是"用 TRAE 做出了什么"，而是"如何与 TRAE 更好地协作"。
从 v1 到 v2 的进化：自 6 月 25 日 v1 发布以来，项目经历了 4 倍增长（229→1,256 次提交）。核心进化包括：四层质量防御体系从概念到落地、L3 模式成熟度标准化（5 个模式从 L1→L2→L3 完整升级路径）、规范自举性验证（方法论达到自举点后自我驱动演化）、15 个 Skills 的三层架构体系、59 个 Wiki 教程的知识体系化建设。
3. Demo 体验地址
交互式 HTML 导航页：见本帖附件
- 四层架构 Mermaid 可视化（感知→认知→执行→治理的完整闭环）
- 量化数据仪表盘（1,256 次提交 / 237+ 个模式 / 140+ 份报告 / 59 个 Wiki / 15 个 Skills）
- 侧边栏导航 + 数字计数动画（页面加载时数字从 0 滚动到目标值）
- 一句话价值主张：「让 AI 协作不再是随机对话，而是有序工程」
开源仓库：https://atomgit.com/daoCollective/SpecWeave （Apache 2.0）
快速开始（3 种方式）
方式一：克隆即用（零配置）
git clone SpecWeave:基于 AGENTS.md 开放标准的多智能体协作开发规范体系项目 - AtomGit | GitCode
将仓库根目录指定为 TRAE 工作目录，TRAE 自动读取 AGENTS.md 作为项目级指令——AI 启动即理解项目架构，无需手动配置。
方式二：脚手架初始化（新项目使用）
python -m agents init --name “MyProject” --type software --lang zh
从 SpecWeave 模板生成新项目的 AGENTS.md + .agents/ 骨架，支持选择角色、项目类型和语言。–dry-run 可预览不生成。
方式三：参考模式（深度定制）
克隆仓库后，参考四层架构和 237+ 个方法论模式，在自己的项目中构建定制化规范体系。
4. TRAE 实践过程
4.1 开发流程
SpecWeave 的开发全程在 TRAE Work CN 中完成，核心流程：
- AGENTS.md 启动协议设计：定义上下文路由表，AI 每次启动自动加载角色定义和协作规范
- 四层架构逐步成形：从单条规则 → 规则集合 → 角色分工 → 四层闭环架构（感知→认知→执行→治理）
- 复盘→洞察→导出闭环：每次对话的经验通过复盘报告沉淀为可复用模式，237+ 个方法论模式全部从具体问题萃取而来
- CI 验证体系搭建：10+ 个自动化脚本覆盖链接检查、规格一致性、源溯源等，确保规范体系自身质量可量化
- HTML 交互增强：在 TRAE 中用对话增强 HTML 导航页（侧边栏导航 + 数字计数动画 + 滚动高亮）
- 四层质量防御体系搭建：L0 模板字段层 → L1 任务执行层 → L2 子代理验收层 → L3 提交门禁层，关键规范点多层纵深防御
- L3 模式成熟度标准化：5 个核心模式经历 L1→L2→L3 完整升级路径，将知识从"文档"转化为"执行门禁"
- 规范自举性验证：方法论达到自举点后自我驱动演化——闭环后 3 次提交内完成"复盘→洞察→模式升级→模板嵌入→实践验证"完整循环
4.2 关键步骤截图
开发过程截图（详见附件）。
4.3 Session ID
| # | Session ID | 对应任务 |
|---|---|---|
| 1 | 2996582939102784:1ae67fd0e645657fe37dda266faa668b_6a3b222481861bccd2bec32c.6a3c847fb9a455f93cfb6a4d.6a3c847fb9a455f93cfb6a4b:TRAE Work CN.0.1.23.no_sid.no_ppe.T(2026/6/25 09:29:35) | 复盘报告归档 + 飞书文档学习 |
| 2 | 121377507783968:5e488b497a5d375eeffe6223352614c1_6a3c97c9c15cfa4586221db2.6a3ca25fc15cfa4586221fda.6a3ca25fc15cfa4586221fd8:TRAE Work CN.0.1.23.no_sid.no_ppe.T(2026/6/25 11:37:03) | HTML 交互增强（侧边栏导航+数字动画） |
| 3 | 121377507783968:5c9cae0508a8cbb0bce00cb3626aac9a_6a3c97c9c15cfa4586221db2.6a3ca48dc15cfa4586222065.6a3ca48dc15cfa4586222063:TRAE Work CN.0.1.23.no_sid.no_ppe.T(2026/6/25 11:46:21) | CI 验证脚本运行 + 项目打磨 |
自 6/25 以来累计 1,256 次 Git 提交，全部通过 TRAE Work CN 完成。
4.4 开发心得
自指涉证明：SpecWeave 的内容是"如何更好地与 AI 协作完成项目"，而它的诞生过程本身就是这个命题的最佳实践——1,256 次 TRAE 对话的量化产出就是证据。不需要解释方法论好不好，体系本身就是证明。
经验沉淀闭环：每次对话的经验通过复盘报告沉淀为可复用模式。140+ 份复盘报告覆盖项目治理、竞品分析、洞察萃取等 10 个维度，237+ 个方法论模式全部从具体问题萃取而来——这不是"一次性灵感"，而是"可复用的工程经验"。
四层质量防御：从 L0 模板字段层到 L3 提交门禁层，关键规范点有 4 层纵深防御，单点失效不导致整体失效。这是从"依靠人力检查"到"依靠体系保证"的关键跃迁。
规范自举演化：方法论达到自举点后能自我驱动演化——"功能完成即结项"模型不再适用。新沉淀的模式被立即用于指导后续开发，形成了"开发→复盘→模式升级→指导开发"的正反馈循环。
TRAE 产品能力延伸：SpecWeave 的 AGENTS.md 体系根植于 TRAE 原生支持的 Rules 特性，是产品能力的系统化扩展。不是"在 TRAE 之外另建一套规则"，而是"将 TRAE 的原生能力系统化为工程体系"。
4.5 行业对标：与 OpenClaw / Hermes Agent 的差异化定位
2026 年 AI Agent 赛道两大头部框架——OpenClaw（GitHub 36 万星，Skill 扩展生态）和 Hermes Agent（GitHub 11 万星，自我进化闭环）——都是 Agent 运行时框架：它们解决的是"如何让 Agent 运行起来、调用工具、沉淀技能"。
SpecWeave 与它们的根本差异在于层级不同：
| 维度 | OpenClaw | Hermes Agent | SpecWeave |
|---|---|---|---|
| 层级 | Agent 运行时框架 | Agent 运行时框架 | Agent 协作规范体系 |
| 核心问题 | 如何让 Agent 拥有更多能力 | 如何让 Agent 自我进化 | 如何让多角色 Agent 在持续协作中保持质量一致 |
| 关键机制 | Skill 系统（扩展能力） | 自进化闭环（执行→提炼→沉淀→复用→自省） | 四层闭环架构（感知→认知→执行→治理） |
| 质量保证 | — | — | 四层质量防御体系（L0-L3） |
| 知识沉淀 | — | — | L3 模式成熟度标准化（5 个 L3 模式） |
| 外部验证 | — | — | 5+ 个外部验证项目 |
| 模型支持 | 主流模型 | 200+ 模型 | 模型无关（规范层，不绑定运行时） |
| 开源协议 | MIT | MIT | Apache 2.0 |
关键洞察：
- 互补而非竞争：SpecWeave 不替代 OpenClaw 或 Hermes，而是为它们提供"协作规范层"
- 品类错位：OpenClaw 和 Hermes 在比"谁的 Agent 更强"，SpecWeave 在回答"如何让 Agent 的协作可预测、可复用、可验证"
- 质量防御的空白填补：两大框架均未涉及"规范体系自身的质量如何保证"——SpecWeave 的四层质量防御体系和 L3 模式成熟度标准化填补了这一空白
5. 报名帖链接与外部验证
报名帖：https://forum.trae.cn/t/topic/44402
关于 SpecWeave 与竹简悟道的关系：竹简悟道（帛书《道德经》AI 反思引导工具）是本账号下已通过审核的主参赛作品，SpecWeave 是方法论基础设施。在竹简悟道开发全程中，SpecWeave 的 AGENTS.md 规范体系让 TRAE 始终理解"反者道之动→玄同"的核心架构意图，从未偏离。这种"方法论指导 + 方法验证"的互为证明，是两个作品之间真正的协同价值。
外部验证项目（5+）
SpecWeave 方法论已在以下项目中得到验证：
| 项目 | 类型 | 验证内容 |
|---|---|---|
| 竹简悟道 | AI 应用开发 | 全程使用 AGENTS.md 启动协议，TRAE 始终保持上下文一致性 |
| 论坛自动化 | 工具开发 | forum-bot.py（Playwright 脚本）遵循 Spec 驱动开发流程，支持 dry-run/幂等检查/自动重试 |
| Tuya IoT | 智能家居集成 | Home Assistant + Tuya 设备集成，使用四不外部依赖原则 |
| Home Assistant | 智能家居平台 | ha_api.py 核心脚本零第三方依赖，已完成重构验证 |
| 火山引擎系列 | 产品学习分析 | 10+ 产品深度分析 Wiki，使用复盘→洞察→导出闭环 |
本文由 SpecWeave 方法论指导下的 AI 智能体协助撰写 | 内容经人工审核确认，观点归属作者本人。