信息
本节文档主要讲解 v3.0 三大核心 — 代币经济学 (Token Economics)、智能体循环工程 (Agentic Loop Engineering)、智能体 Harness (Agentic Harness) — 中第三大核心的实现细节。让智能体写好代码的秘诀不在模型本身，而在于围绕模型的环境设计。

Harness 是如何组装的

MoAI-ADK Harness 由 7 个组成部分分层协作。越往下的层越动态。

flowchart TD
    CLAUDE["CLAUDE.md
项目宪法"] --> SETTINGS["settings.json
权限与环境配置"]
    CLAUDE --> RULES[".claude/rules/
条件规则"]

    SETTINGS --> HOOKS["Hooks
事件自动化"]
    SETTINGS --> MCP["MCP 服务器
外部工具连接"]

    RULES --> SKILLS["Skills
专业知识模块"]
    SKILLS --> AGENTS["Agents
专家智能体"]

    AGENTS --> BUILDERS["Builder Agents
扩展生成器"]

如果说 CLAUDE.md 是项目的宪法，那么 settings.json 就是权限的边界线，Hook 是确定性 (deterministic) 控制点，Skill 与 Agent 则是真正干活的双手。而 Builder Agents 可以重新生成这整个结构 — 这是一个 Harness 制造 Harness 的递归结构。

主题	说明
代币经济学概览	单价下降 98% 而成本上升 320% 的悖论及其解法
Token 预算	Token Circuit Breaker · verify-diet · 上下文瘦身
No-Haiku 三层	DeepSWE 排行榜依据与三层策略
Profile 矩阵	11 个智能体 × `{model, effort}` 33 格单一 profile 轴
statusline	上下文使用率·缓存命中率·rate limit 常驻仪表盘

自我改进 —— 智能体循环工程

主题	说明
自进化系统	4 层学习阶梯（观察 → 启发式 → 规则 → 自动更新）
自主循环	`/moai goal` · `/moai loop` 条件声明型·诊断驱动循环
决策记忆	学习用户选择的观察系统
ultracode 工作流	动态工作流编排（多智能体扇出）

品质把控 —— 智能体 Harness

主题	说明
技能指南	赋予 AI 专业知识的技能系统
智能体指南	专业化 AI 任务执行者体系
构建器智能体指南	生成技能、智能体、命令与插件
Harness v4 Builder	用一句自然语言生成项目专属 Harness
Harness 配置档案与评估系统	3 层验证深度 + 4 维评分
目录系统	3 层清单与 slim init

控制与自动化

主题	说明
Hooks 指南	基于事件的自动化脚本
Hooks 参考	MoAI-ADK 分发的 Hook 列表
settings.json 指南	Claude Code 全局设置管理
config 章节	`.moai/config/sections/*.yaml` 配置项参考
CLAUDE.md 指南	项目指令文件体系
@MX 标签	智能体间上下文·不变契约·危险区的内联标注
安全说明	权限栈与沙箱

信息
每篇文档均可独立阅读。不过如果想系统地理解整体架构，推荐按 技能指南 → 智能体指南 → 构建器智能体 的顺序阅读 — 从知识模块到执行者、再从执行者到生成器的脉络，正是 Harness 递归结构的直接体现。

深入学习

Harness 是如何组装的

目录

成本 —— 代币经济学

自我改进 —— 智能体循环工程

品质把控 —— 智能体 Harness

控制与自动化