本文由 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 导航页（Zip 格式打包上传至本帖附件）：
- 四层架构 Mermaid 可视化（感知→认知→执行→治理的完整闭环）
- 量化数据仪表盘（1,256 次提交 / 237+ 个模式 / 140+ 份报告 / 59 个 Wiki / 15 个 Skills）
- 侧边栏导航 + 数字计数动画（页面加载时数字从 0 滚动到目标值）
- 一句话价值主张：「让 AI 协作不再是随机对话，而是有序工程」
开源仓库：https://atomgit.com/daoCollective/SpecWeave （Apache 2.0）
快速开始（3 种方式）
方式一：克隆即用（零配置）
git clone https://atomgit.com/daoCollective/SpecWeave
将仓库根目录指定为 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 关键步骤截图
开发过程全程在 TRAE Work CN 中完成，1,256 次提交记录可通过 git rev-list --count HEAD 验证。
4.3 Session ID
| # | Session ID | 对应任务 |
|---|---|---|
| 1 | 2996582939102784:1ae67fd0e645657fe37dda266faa668b | 复盘报告归档 + 飞书文档学习 |
| 2 | 121377507783968:5e488b497a5d375eeffe6223352614c1 | HTML 交互增强（侧边栏导航+数字动画） |
| 3 | 121377507783968:5c9cae0508a8cbb0bce00cb3626aac9a | 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 特性，是产品能力的系统化扩展。
4.5 行业对标：与 OpenClaw / Hermes Agent 的差异化定位
2026 年 AI Agent 赛道两大头部框架——OpenClaw（GitHub 36 万星）和 Hermes Agent（GitHub 11 万星）——都是 Agent 运行时框架。SpecWeave 与它们的根本差异在于层级不同：
| 维度 | OpenClaw | Hermes Agent | SpecWeave |
|---|---|---|---|
| 层级 | Agent 运行时框架 | Agent 运行时框架 | Agent 协作规范体系 |
| 核心问题 | 如何让 Agent 拥有更多能力 | 如何让 Agent 自我进化 | 如何让多角色 Agent 协作质量一致 |
| 关键机制 | Skill 系统 | 自进化闭环 | 四层闭环架构 |
| 质量保证 | — | — | 四层质量防御体系（L0-L3） |
| 知识沉淀 | — | — | L3 模式成熟度标准化 |
| 外部验证 | — | — | 5+ 个外部验证项目 |
| 模型支持 | 主流模型 | 200+ 模型 | 模型无关（规范层） |
关键洞察：SpecWeave 不替代 OpenClaw 或 Hermes，而是为它们提供"协作规范层"——互补而非竞争。
5. 报名帖链接与外部验证
报名帖：https://forum.trae.cn/t/topic/44402
关于 SpecWeave 与竹简悟道的关系：竹简悟道（帛书《道德经》AI 反思引导工具）是本账号下已通过审核的主参赛作品，SpecWeave 是方法论基础设施。在竹简悟道开发全程中，SpecWeave 的 AGENTS.md 规范体系让 TRAE 始终理解核心架构意图，从未偏离。
外部验证项目（5+）
| 项目 | 类型 | 验证内容 |
|---|---|---|
| 竹简悟道 | AI 应用开发 | 全程使用 AGENTS.md 启动协议 |
| 论坛自动化 | 工具开发 | forum-bot.py 遵循 Spec 驱动开发流程 |
| Tuya IoT | 智能家居集成 | Home Assistant + Tuya 设备集成 |
| Home Assistant | 智能家居平台 | ha_api.py 核心脚本零第三方依赖 |
| 火山引擎系列 | 产品学习分析 | 10+ 产品深度分析 Wiki |
本文由 SpecWeave 方法论指导下的 AI 智能体协助撰写 | 内容经人工审核确认，观点归属作者本人。