制品注册表

制品集的规范登记册。 本文档承载命令、规则、委派工作者、钩子、技能、输出样式、制品演进纪律以及空制品类声明的完整枚举；实质性表格存放于此。项目源代码布局提供了精简的常驻视图。

1. 命令Copy Anchor Link

从 src/apothem/commands/*.md（非递归）注册了四十五个命令——完整且始终最新的逐命令参考是生成的命令参考，十三阶段的 /research 流水线（/research-ideate 至 /research-disseminate）以及 /audit 和 /fortress 封装工作流编排器都在那里完整列出。每个命令都是一等的已注册文件；/plan 编排器仅串联本已是一等的 plan 阶段，自身不携带任何阶段逻辑，因此仍然没有单体调度器，也没有子命令分组。

三十五个命令可由模型调用（disable-model-invocation: false）：当请求与其描述匹配时，模型可以运行它。十个命令仅由操作员调用：/freshify、/github-deploy-fresh、/github-deploy-next、/release-readiness、/elevate、/fortress、/workflow、/plan-execute、/research-experiment 和 /research-publish。逐命令的标志记录在 src/apothem/commands/README.md 中。

非 plan、非 research 的审计与提升命令：

Plan 流水线命令Copy Anchor Link

plan 流水线作为八个一等命令交付——每个阶段一个，可从其各自的已注册文件 src/apothem/commands/plan-<stage>.md 直接以 /plan-<stage> 调用。

操作员工作流与编排器命令Copy Anchor Link

三个命令进入一套深度流程，而非自带阶段逻辑：两个操作员工作流入口点（各由同名的配套技能支持），外加薄型 plan 流水线编排器。

2. 规则Copy Anchor Link

行为规则存放于 src/apothem/rules/ 下——一个小型的常驻核心加上一个较大的路径过滤集合（在匹配的制品触及时按需加载）。完整的逐规则枚举——带有 Scope（常驻 / 路径过滤）与 Implements 列——是源生成的 reference/rules.mdx，由参考清单生成器从 src/apothem/rules/*.md 刷新；权威的当前清单请查阅它。

CM-21 切面划分（三条规则以彼此不重叠的不同切面共同实现 CM-21）：创意过滤器与认知身份 → cognitive-identity.md；生成方法论（撰写与重写协议） → clean-room-generation.md；计划/审查技术 → planning-techniques.md。每条规则各拥其切面；其余规则向外引用。

交互式询问 schema 指针。 规范的结构化询问调用 schema——必填字段、字段摘要表、两个可执行的示例（§2.1 单选与 §2.2 多选）——存放于 src/apothem/rules/interactive-questions.md §2 "Structured-Inquiry Shape"。下游制品可复制 §2.1 或 §2.2 作为调用模板；每个选项的 description 主体所承载的三段式选项注释 schema 在同一文件的 §3 中规定。

3. 委派工作者Copy Anchor Link

生态系统随附十四个持久化工作者定义；编排规则的团队模式向它们派遣。每个定义存放于下方列出的文件路径。

Worker              File                                       Pattern         Model Policy
------------------- ------------------------------------------ --------------- -------------
Citation Auditor    src/apothem/agents/citation-auditor.md    Audit           host-selected
Codebase Explorer   src/apothem/agents/codebase-explorer.md   Research        host-selected
Convention Auditor  src/apothem/agents/convention-auditor.md  Audit           host-selected
Dependency Auditor  src/apothem/agents/dependency-auditor.md  Audit           host-selected
Design Critic       src/apothem/agents/design-critic.md       Audit           host-selected
Fact Checker        src/apothem/agents/fact-checker.md        Audit           host-selected
MCP Builder         src/apothem/agents/mcp-builder.md         Generation      host-selected
Memory Auditor      src/apothem/agents/memory-auditor.md      Audit           host-selected
Prompt Evaluator    src/apothem/agents/prompt-evaluator.md    Quality         host-selected
Quality Gate        src/apothem/agents/quality-gate.md        Quality         host-selected
Refactor Surgeon    src/apothem/agents/refactor-surgeon.md    Implementation  host-selected
Research Scout      src/apothem/agents/research-scout.md      Research        host-selected
Security Scanner    src/apothem/agents/security-scanner.md    Audit           host-selected
Test Runner         src/apothem/agents/test-runner.md         Quality         host-selected

4. 钩子Copy Anchor Link

已安装的 Claude Code 钩子条目使用 exec 形式：command 为 ${PYTHON_BIN}，args 保存位于 ${HARNESS_ROOT}/.apothem/support/ 下的脚本路径（例如 hooks/dispatch.py 和 conformity/gate.py）。-m apothem.hooks.dispatch 形式仅用于在设置了 PYTHONPATH=src 的源码检出中进行开发。调度器会导入 src/apothem/hooks/lib/resolve_root.py 以解析生态系统根目录，并委托给与之并列、同样位于 src/apothem/hooks/ 之下的两个辅助模块：src/apothem/hooks/emit_hook_context.py 为助手格式化事件载荷，src/apothem/hooks/session_start_bootstrap.py 则承载调度器在路由 SessionStart 事件时移交的准备工作。支持的事件触发时呈现给助手的钩子消息，以 Markdown 上下文文件的形式存放于 src/apothem/hooks/messages/ 之下，每个事件变体一个：postcompact.md、precompact.md、posttooluse-proactive-compaction.md、pretooluse-askuserquestion-recommended.md、pretooluse-bash.md、pretooluse-bash-plan-guard.md、pretooluse-conformity.md、pretooluse-dependency-guard.md、pretooluse-edit.md、pretooluse-edit-header-guard.md、pretooluse-eval-guard.md、pretooluse-notebookedit.md、pretooluse-write.md、pretooluse-write-header-guard.md、pretooluse-write-plan-guard.md、sessionstart.md、skill-index.md、stop.md。每个被路由的上下文文件，都会在其事件触发时由调度器加载，前提是其上下文参数已在 settings.json 中注册。pretooluse-conformity.md 作为可用变体随附，但目前在 settings.json 中没有对应的路由条目。skill-index.md 由技能与命令目录生成，并由会话开始引导程序读取，而不经由 settings.json 路由。pretooluse-dependency-guard.md 通过 Write 和 Edit 匹配器路由，pretooluse-eval-guard.md 则通过 Write、Edit 和 Bash|PowerShell 匹配器路由。

Event             Automates                Timeout  Purpose
----------------- ------------------------ -------- --------------------------------------------------
SessionStart      CM-14                    30s      Read memory, check plan state, report readiness
PreCompact        CM-24                    30s      Verify state externalized before compaction. Codex and Qwen Code register it; the Claude Code settings.json template does not
PostCompact       CM-24                    30s      Restore working state after compaction. Codex and Qwen Code register it; the Claude Code settings.json template does not
Stop              CM-14/CM-22/CM-24/CM-26  60s      Session-end externalization
PreToolUse        CM-7/CM-22               10s      Write/Edit/NotebookEdit validation — codebase-isolation, frontmatter, license-header, and plans-locality checks plus the conformity gate. Bash validation — git artifact isolation and plans-locality
PostToolUse       Proactive compaction     10s      Proactive-compaction advisory on every tool call; the Claude Code settings.json template routes it on the all-tools matcher
UserPromptSubmit  —                        10s      Accepted by src/apothem/hooks/dispatch.py whitelist for forward compatibility; no settings.json entry currently routes this event
Notification      —                        10s      Accepted by src/apothem/hooks/dispatch.py whitelist for forward compatibility; no settings.json entry currently routes this event

约定。 Automates 为 — 的行被 dispatch.py 接受但未在 settings.json 中接线；Timeout 列展示在该事件日后接线时适用的调度级默认值。

超时值规范块。 本表的 Timeout 列是生态系统中钩子超时值的单一真相源。settings.json 中的逐钩子 timeout 字段、site/content/docs/reference/settings-reference.mdx § Hook Events 和 site/content/docs/reference/artifact-schema.mdx § Hooks Pipeline 中的镜像表，以及 src/apothem/rules/persistent-conventions-vigilance.md § Convention Awareness 中的规则指导，全部源自此列。未来的超时修订落在此处，消费方在下次引用时重新推导。

设置模板审查节奏Copy Anchor Link

settings.json 是单一的 Claude Code 模板。每个钩子命令使用 exec 形式而非特定于 shell 的包装器，因此跨 OS 行为 在单个文件内审查，而非通过对比成对模板。新的权限条目、 钩子事件、超时与状态消息原子性地落入该文件。

5. 技能Copy Anchor Link

可复用技能存放于 src/apothem/skills/ 之下，每个技能一个文件夹。

带有 disable-model-invocation: true 的技能只有在操作员按名称调用时才会运行。二十个技能可由模型调用。四个技能是手动的，因为它们会改变工作树之外的状态，或依赖操作员选择时机：Dependency Upgrade、Secret Rotation、Workflow 和 Issue Lifecycle。两个套件技能是按路径读取的仅供参考的模板。会话开始时的技能索引按领域列出可由模型调用的技能名称和手动技能名称。

约定。 每行的 Path 是一个文件夹；入口点是其内部的 SKILL.md 文件——例如 src/apothem/skills/plan-suite/SKILL.md——遵循项目源代码布局中声明的文件夹带 SKILL.md 的技能约定。

6. 输出样式Copy Anchor Link

四个输出样式存放于 src/apothem/output-styles/ 之下。

7. 制品演进Copy Anchor Link

强制性。 当一个可复用的模式、纠正或技术反复出现（一次会话中 2 次以上，或在记忆中被标注为反复出现）时，生态系统必须演进。该周期有四个步骤：在任何交互期间检测模式；搜索现有的技能、规则、命令、钩子与记忆以寻找重叠；通过就地演进匹配的制品（更新流程、反模式、范围）或在该关注点确实正交时创建新制品来行动；验证交叉引用仍然可解析且依赖制品保持一致。优先细化而非创建——新制品会累加维护面。完整协议（包括跨每个制品类的封闭式缺口检测触发器目录）参见 src/apothem/rules/persistent-conventions-vigilance.md §2+§4。

8. 空制品类Copy Anchor Link

在生态系统注册表中已声明但在激活触发器触发之前刻意留空的界面。每行记录保留的界面、为该类搭建脚手架的文件或目录，以及将该行从空声明提升为已填充的触发器。

空声明是一种正向声明，而非缺口。该类的脚手架（如有）是追踪激活时刻的规范无操作制品。从空声明到已填充的提升，与脚手架的首个非空值原子性地落入相关注册表小节。