概念

贯穿整个 Apothem 文档时你将遇到的术语的快速参考。

共享配置档案

位于 ~/.config/apothem/profile.yaml 的经模式校验的 YAML 文件（用 --profile PATH 覆盖）。它是你的身份、偏好与配置的唯一真相来源；每个工具适配器在安装时读取它，并从中派生该工具的原生配置。

工具适配器

一种按平台划分的适配器，将共享配置档案转换为特定助手运行时的原生配置格式。受支持的运行时列举如下：

Claude Code, Cursor, Gemini CLI, etc.

安装 Apothem 始终意味着：先安装共享配置档案，然后物化一个或多个适配器。

行为规则

src/apothem/rules/ 下的 Markdown 文件，在每次交互时加载（始终启用），或仅在编辑特定路径下的文件时加载（路径过滤）。规则将助手运行时应如何行为加以编码固化。

钩子

注册在 settings.json 中的 Python 脚本，在工具生命周期事件（PreToolUse、PostToolUse、SessionStart、PreCompact、Stop、PostCompact）触发。钩子在输出落盘之前实时强制执行合规义务。钩子事件模型目前是 Claude Code 的一项界面；对于没有钩子机制的工具，其适配器直接将其省略。

合规闸门

十五道预发布闸门（M1-M15）中的机械部分——任何制品发布前必须通过的独立校验器。预发布闸门是质量底线；合规闸门运行其中可由机器检查的关卡，而钩子则实时强制执行各道关卡。

计划套件

位于 <project-root>/.apothem/plans/<suite-name>/ 的结构化目录，包含一份规格说明、一份主计划、每阶段的 PHASE.md 文件以及输出制品。/plan 流水线管理计划套件。

技能

一种可复用、可通过斜杠命令调用的技术，打包为 src/apothem/skills/<name>/ 下的 SKILL.md 文件。技能将斜杠命令界面扩展到内置的 /plan 流水线之外。

受托工作者

一种持久的、按目的划定范围的助手，定义于规范路径：

src/apothem/agents/<name>.md

受托工作者负责处理调研、审计、质量检查和记忆管理。