🦞claw-code标本馆 · 教学站
Specimen No. 08 · Glossary

术语表

30 个关键术语速查:概念、工具、项目机制、参考对照。读完本页约 8 分钟,建议随时回查。

建议先读 01–07,本页用于随时回查

概念层

智能体(Agent)
能自主规划、调用工具、观察结果并迭代执行的 AI 程序,而不是只回答一句话的聊天模型。本项目里"claws"就是一群编码智能体。
vibe coding
Karpathy 于 2025 年命名的玩法:完全顺着感觉把代码交给 AI,甚至不看代码。本项目的反面——它把验证加回来了。
agentic engineering(智能体工程)
让 agent 承担执行,但用流程、工具边界、验证与人工门约束它的工程形态。本项目是它的公开样本。
march of nines
可靠性每提高一个九(90%→99%→99.9%…),成本指数级上升。用来理解"为什么 AI 代码要配那么多验证"。
上下文窗口(context window)
agent 一次能"记住"的 token 上限,当前最稀缺的资源之一。clawhip 把通知移出窗口,就是为了省它。
LLM(大语言模型)
本项目的"大脑":claw 通过 API 调用 Anthropic / OpenAI 兼容 / xAI 等模型,而不是自己内置模型。

工具层

REPL
交互式命令行环境,输入一句、执行一句。运行 claw 不带参数就进入 REPL。
slash 命令
REPL 里以 / 开头的命令,本项目有 120+ 个:/doctor/skills/mcp/subagent 等。
MCP(Model Context Protocol)
让 agent 连接外部工具/数据源的标准协议(类似 USB-C 之于外设)。claw 用它管理服务器生命周期与资源。
RAG(检索增强生成)
先检索相关资料再生成回答,减少幻觉。本项目的 claw-rag-service 就是对代码做 RAG 的服务。
Embedding / 向量检索 / Qdrant
把文本变成向量、按语义相似度搜索的技术栈。MVP 用 SQLite 线性余弦,可升级到 Qdrant 做 ANN。
Provider(模型服务商)
提供模型 API 的一方。本项目按模型前缀自动路由:claude-*、openai/、grok、qwen/ 等。
SSE(流式)
服务器向客户端逐块推送数据的协议,让 AI 的回答像打字一样流出来。
权限模式
read-only / workspace-write / danger-full-access 三档,控制 agent 能碰什么;默认收紧。
allowedTools
细粒度只放行指定工具的命令行开关,配合权限模式做双重约束。

项目机制

parity(对账)
对照参考实现逐项核对行为是否一致。本项目用 PARITY.md + mock 服务做自动化对账。
verification map(验证对照图)
把"承诺做什么"与"证据在哪"一一对应的文档(docs/g002–g013),是"可审计"的载体。
quality gate(质量门)
一组必须全部通过才放行的检查(fmt/clippy/test/py_compile)。相当于 CI 里的人工检查点。
ledger(账本)
追加式的运行记录。.omx/ultragoal/ledger.jsonl 记下协调系统的每一步动作。
worker / leader
本项目内部的多 agent 分工:worker-1..4 并行干活,leader 负责合并、验证与对齐提交。
doctor
内置健康检查命令:验证 API key、模型访问、工具配置。项目的"第一道体检"。
anti-slop(防灌水)
处理低质量/机器生成 PR 的政策框架;核心红线是"自动化不得 merge/close",最终门留给人类。

参考对照(Claude Code / ccleaks)

sourcemap 泄露
构建产物里附带源码映射文件,可被逆向还原源码。ccleaks 正是从 npm 包里的 cli.js.map 还原出 Claude Code 的 TypeScript 源码。
feature flag(功能开关)
编译期/运行期开关,控制功能是否可见。泄露源码分析列出了 32 个构建期 flags 与 GrowthBook 的 tengu_* 灰度门。
beta header
Anthropic API 的 anthropic-beta 请求头,用于开通 1M 上下文、结构化输出、工具搜索等新能力。
YOLO 自动授权
Claude Code 泄露源码中的 classifyYoloAction():让模型自评工具调用风险(LOW/MEDIUM/HIGH),低风险免确认执行。claw-code 走的是显式闸门路线。
undercover 模式
泄露源码披露的内部功能:在公开仓库提交时自动抹掉所有 AI 痕迹。与 claw-code "把 agent 痕迹当展品公开"形成鲜明对照。
反蒸馏(anti-distillation)
向 API 响应注入假工具定义,防止竞品用输出训练模型。属商业防御手段,与教学质量无关但对理解行业生态有用。
worktree
git 的并行工作区机制,可在不打扰当前分支的前提下开新工作树。泄露源码里 --worktree 用于隔离 agent 工作。
agent swarm / worker 池
多个 agent 并行工作的编排方式。claw-code 的 worker-1..4 + leader 就是一个最小 swarm。
仓库自己的"文档地图"README.md · Documentation map
- USAGE.md — quick commands, auth, sessions, config, parity harness - docs/navigation-file-context.md — terminal navigation, scrollback, @path file context - docs/local-openai-compatible-providers.md — Ollama/llama.cpp/vLLM setup - docs/windows-install-release.md — PowerShell-first install, release artifact - rust/README.md — crate map, CLI surface, features - PARITY.md — parity status for the Rust port - ROADMAP.md — active roadmap and open cleanup work - PHILOSOPHY.md — why the project exists and how it is operated
来源:claw-code/README.md · Documentation map(节选)
课后小练习

练习 · 给"agent 写代码、人类只做验收与方向"这个流程起一个你自己的术语,写一句话定义,并说明它和 vibe coding 的异同。

提示:可参考 "agentic engineering""direction-driven development" 等命名思路。

← PREV
07 · 时间线