术语表 | 野渡

一句话

本系列统一使用的说法。笔记里遇到这些词，都按这里的定义理解。

本表按 Matt domain-modeling 的格式写：只收本系列特有的概念，每条一到两句，"避免"列出不再使用的同义说法。

构件

技能（Skill）：一个含 SKILL.md 的目录。agent 按它的描述触发，按它的步骤执行。本系列一篇笔记对应一个技能。避免：插件、提示词

命令（Command）：包装一个或多个技能的斜杠入口，比如 addy 的 /spec。写进仓库概览，不单独成篇。避免：把命令叫成技能

人格（Persona）： agents/*.md 里定义的子代理角色，有固定视角和输出格式，比如 addy 的 code-reviewer、pstack 的 Comment Sicko。避免：单独说"agent"

剧本（Playbook）： pstack 的 poteto-mode 里按顺序执行的一组步骤，共 23 个。避免：工作流、流程

原则（Principle）： pstack 的 principle-*，一条规则一个技能。用名字纠偏，不需要调用。

规则（Rule）： Cursor 的 .mdc 常驻指令，比如 cursor-team-kit 的 typescript-exhaustive-switch。避免：原则

钩子（Hook）：宿主在工具调用前后或会话事件上自动运行的脚本，比如 addy 的 sdd-cache、Matt 的 git-guardrails-claude-code。

用户调用（User-invoked）：只能由人敲命令触发的技能，frontmatter 里有 disable-model-invocation: true。笔记属性 invoke: user。

模型调用（Model-invoked）： agent 可以按描述自动触发、人也可以手动调用的技能。笔记属性 invoke: model。

路由器（Router）：替你挑选技能的技能：using-agent-skills、ask-matt、poteto-mode、poteto-help。避免：元技能（只在引用 addy 原文时使用）

主路由（Primary router）：同一时刻唯一启用的路由器。两个路由器同时开会互抢命令和路由。

工作流（Workflow）：按任务规模选用的一条跨阶段技能链，带 token 旋钮。本系列有 W1 到 W7，见 00-怎么选工作流。避免：流程、流水线、playbook

阶段（Phase）：笔记属性 phase 的取值：调研 research、定义 define、计划 plan、构建 build、验证 verify、评审 review、交付 ship、运维 operate，另有 meta 表示关于 agent 自身的技能。

旋钮（Knob）：工作流里可调的强度档位，分省、标准、加强三档。

成本档（Cost tier）：笔记属性 cost。low 是一次完成、不开子代理；mid 是开 1 到 3 个子代理或要循环；high 是多路并行、多模型或长时间自动运行。

本机状态（Local status）：笔记属性 local。same 是本机已装且与仓库一致；outdated 是本机已装但内容不同；missing 是本机未装。记录时间为 2026-06-13。

智能区（Smart zone）：模型仍能清醒推理的上下文范围。Matt 给的经验值约 150k token。

阶段边界（Phase boundary）：两个阶段之间的空当。只在这里决定继续、/clear、/handoff、开子代理还是 /compact，阶段中途不换上下文。

"每个 skills 一篇笔记"中的 skills 指技能，不是仓库。例外：pstack 的 24 条原则合成一篇，benny 的 3 个技能合成一篇。
"工作流"在三个仓库里含义不同：Matt loop-me 的 workflow 是一个日常循环的规格，ask-matt 的 flow 是穿过若干技能的路径，pstack 的 playbook 是剧本。本系列只把按任务规模选用的技能链叫工作流。
"兼容开发周期和 token 开销"指：按任务规模和周期分档，每档都覆盖调研到交付，并标出 token 开销和旋钮。
术语表文件名：Matt 仓库新版用 GLOSSARY.md，本机旧版 domain-modeling 用 CONTEXT.md。本系列不是代码仓库，术语表放在本笔记里。