TMCP

TMCP 将分散的 Agent 指令转化为针对特定任务的操作包。用户用自然语言描述工作。TMCP 会推断任务身份，从技能/规则/证据中编译出当前最完善的操作包；随着工作变化，它会重新编译，并留下审计记录。

技能名称用于标明来源，而不是作为用户界面。高级用户仍可强制指定路由；默认方式是使用自然语言提示。

TMCP 可独立运行于仓库检出目录、复制的插件包、Codex 插件缓存、Claude 插件缓存，或任何能够启动随附 Node 入口点的 MCP 主机。原有的 AIOS 适配器已弃用，默认禁用；仅设置 AIOS_ROOT 不再会启用它。

有关自适应操作包运行时的设计，请参阅 docs/ADAPTIVE_PACKET_RUNTIME.md。

快速入门

在 TMCP 检出目录或插件根目录中：

node scripts/tmcp_launcher.mjs doctor
node scripts/tmcp_launcher.mjs status
node scripts/tmcp_launcher.mjs compose-packet "Improve this agent run" --project-path . --phase start
node scripts/tmcp_launcher.mjs harvest skills --limit 5 --no-write-artifacts
node scripts/tmcp_launcher.mjs recommend skills --candidate-workflows release_readiness --candidate-workflows developer_experience --min-confidence 0.1 --compose --no-write-artifacts

不带参数时，同一个启动器会启动 MCP stdio 服务：

node scripts/tmcp_launcher.mjs

安装布局

• 仅安装技能：将 skills/tmcp 复制到技能目录。使用该技能进行路由和手动合成操作包，除非主机也提供随附的启动器。
• 仓库检出：克隆仓库，然后在检出目录根目录运行 node scripts/tmcp_launcher.mjs doctor。
• Codex 插件缓存：将其安装为 Codex 插件；MCP 配置会从插件根目录启动相对路径 scripts/tmcp_launcher.mjs。
• 共享本地运行时：使用 scripts/tmcp_runtime.mjs 安装经过验证的归档，以便所有 Agent 主机共用一个固定版本的活动发行版，并支持离线回滚。请参阅中央运行时。
• 已弃用的 AIOS 兼容模式：需要同时设置 TMCP_ENABLE_DEPRECATED_AIOS_ADAPTER=1 和 AIOS_ROOT；新安装应使用独立的 TMCP。

Claude Desktop 用户可以将启动器添加为本地 stdio MCP 服务。请参阅 docs/CLAUDE_DESKTOP.md。

稳定性范围

TMCP 对三个独立部分进行标注：

• 技能包：tmcp、skill-harvest、workflow-recommendation、release-readiness 和 dx-audit 是稳定的路由包。
• 精选工作流模板：release-readiness 和 dx-audit 是推荐目录中的稳定模板。
• MCP 工具契约：doctor、status、explain、compose-packet 和 runtime-next 是稳定的。收集、评估、推荐、晋级、回执和专家评审标准工具仍处于实验阶段。

实验性模板和工具仍会随软件发布且可供调用。它们会在各自的输出和 frontmatter 中标记为实验性，以免用户将稳定的包路由与稳定的工具契约或精选模板混为一谈。

实验性工作流包括 UI 评审标准、安全/隐私、测试策略、自适应工作流包、自定义评审标准生成、路由策略、技能差距分析、事件复盘、架构决策、迁移就绪度、Agent 交接、PR 风险、性能就绪度、数据完整性、公共部门就绪度，以及仓库行为规范循环。

工具

工具	用途
tmcp_doctor	检查首次运行的就绪状态和支持的安装布局。
tmcp_status	报告独立运行能力和可选的 AIOS 适配器状态。
tmcp_explain	编译针对特定任务的 TMCP 数据包。
tmcp_compose_packet	编译任务／阶段运行数据包，其中包含 task_identity、packet_markdown 和来源信息。
tmcp_runtime_next	运行时证据发生变化后，返回数据包差异或完整重新编译的数据包（output_mode: full）。
tmcp_record_receipt	在具备安全持久化能力的主机上，于验证或任务完成后写入一条建议性运行回执。
tmcp_harvest_skills	将本地技能、说明、规则、文档和工作流收集为来源节点。
tmcp_evaluate_skills	根据完整的 SKILL.md 输入创建或评分技能评估计划。
tmcp_recommend_workflows	根据收集的证据推荐稳定或实验性工作流，并提供稳定性元数据。
tmcp_promote_harvest	明确将审核过的收集信号提升为持久化的来源到原子、原子到工作流图谱构件。
expert_rubric_review_plan	生成专业能力数据包、评分量规、证据审计、补救计划和验证预期。

安全

收集功能默认会对看起来敏感的值和类似机密的来源路径进行脱敏，并将收集到的说明视为不可信文本。默认收集行为会排除 .env*、凭据、令牌、浏览器配置文件、私有缓存、依赖树、构建输出、VCS 数据以及生成的 TMCP/AIOS 构件。除非明确启用 follow_symlinks，否则不会跟随来源符号链接；即使启用了此选项，链接仍必须解析到所选来源根目录内。

在支持安全的基于文件描述符的相对文件系统操作的主机上，收集构件会通过符号链接安全的目标路径，以一个暂存的原子化套件写入。将 output_dir 留空可使用唯一的 .tmcp/harvest-* 目录，也可以提供一个新建或空的输出目录。

技能评估接受显式指定的普通 SKILL.md 输入，可将其限制在提供的项目根目录内，并会在生成报告前对来源、计划和证据值进行脱敏。初始计划构件会以暂存套件的形式写入新建或空目录；证据评分可安全地将报告添加到同一目录。

如果不支持这些安全文件系统操作，则无法持久化构件。doctor 和 status 会报告此能力；若需进行可移植分析，请使用 --no-write-artifacts，并参阅兼容性了解相关限制。

tmcp_record_receipt 没有非持久化预览，因为回执本身就是构件。只有在 status 报告构件持久化可用时，才运行此命令。

数据包会话同样有明确限制：只有在安全持久化可用时，compose-packet --session-id 才会写入一条经过脱敏的项目本地最新数据包记录。会话用于单次串行运行，不是全局历史记录或协调服务。请参阅 CLI 会话约定。

如果收集到的来源试图覆盖系统、开发者或用户指令，TMCP 会发出警告。请参阅 SECURITY.md。

示例

收集本地技能文件夹：

node scripts/tmcp_launcher.mjs harvest ./skills --objective "Harvest reusable skill behavior" --limit 20 --no-write-artifacts

为项目推荐工作流：

node scripts/tmcp_launcher.mjs recommend . --candidate-workflows release_readiness --candidate-workflows developer_experience --min-confidence 0.1 --compose --no-write-artifacts

整理当前任务数据包，并在运行期间重新编译。此会话流程要求 status 报告工件持久化可用：

node scripts/tmcp_launcher.mjs compose-packet \
  "Redesign these pages. Make them visually striking, interactive, modern, motion-rich, and production-ready." \
  --project-path "$PWD" --phase start --session-id redesign-run

node scripts/tmcp_launcher.mjs recompile-packet \
  "Redesign these pages..." \
  --project-path "$PWD" \
  --current-phase runtime \
  --session-id redesign-run \
  --files-changed app/page.tsx

node scripts/tmcp_launcher.mjs record-receipt packet-123 --activated-atoms ui-browser-verification --outcome passed

会话持久化不可用时，可通过 --previous-packet 内联传递先前整理的 JSON，以保留兼容路径。

仅使用旧版增量的运行时路由：

node scripts/tmcp_launcher.mjs compose-packet "Fix the dashboard UI bug" --project-path . --phase start
node scripts/tmcp_launcher.mjs runtime-next "Fix the dashboard UI bug" --current-phase verification --files-changed app/page.tsx --failures "vitest failed"
node scripts/tmcp_launcher.mjs record-receipt packet-123 --activated-atoms ui-browser-verification --outcome passed

将审核通过的收集信号提升为持久路由工件：

node scripts/tmcp_launcher.mjs promote-harvest . --selected-workflows release_readiness_workflow --output-dir .tmcp/promoted-harvests/release-readiness

在支持安全持久化的主机上，提升操作还会在 TMCP_HOME/promoted-harvests/<opaque-promotion-key>/ 下持久化经过脱敏的建议图；若未设置 TMCP_HOME，则保存在 ~/.tmcp/promoted-harvests/<opaque-promotion-key>/ 下。回执保存在 TMCP_HOME/receipts/<yyyy-mm>/ 下。 全局缓存内容仅供参考，不能覆盖系统、开发者、用户或项目指令。 除非调用方显式传入 --cache-policy global，否则数据包整理和运行时路由不会读取该缓存；默认策略为 none。

根据证据片段进行专家量规评审：

node scripts/tmcp_launcher.mjs review-plan "Review release portability" \
  --project-path . \
  --evidence-json '[{"dimension_id":"source_grounding","severity":"warning","summary":"Release claims need fresh package evidence.","evidence":["python3 scripts/check_release_package.py ."],"recommended_fix":"Run and cite the release package check before publishing."}]' \
  --no-write-artifacts

更多示例请见 examples。开发者入门和发布准备度练习使用稳定的精选模板；技能收集和推荐示例仍可通过实验性工具契约使用。

验证

发布前：

python3 -m unittest discover -s tests
python3 scripts/release_package_compile.py .
node --check scripts/tmcp_launcher.mjs
python3 scripts/check_contracts.py .
python3 scripts/check_install.py .
python3 scripts/check_release_package.py . --verify-reproducible

发布包检查会从经过审查的干净 Git 修订版本构建，而非从工作目录构建。它仅打包明确列入允许清单的已提交文件，拒绝不安全路径、符号链接和类似机密的内容，然后生成确定性的 RELEASE_MANIFEST.json 和归档摘要。CI 发布门禁会从同一 Git 树重复构建，并要求两个摘要一致。它还会验证前置元数据、硬编码的本地路径、私有示例名称、链接、提取后软件包的安装结构、doctor、示例收集、示例工作流推荐、示例专家量规规划、编排／运行时／回执冒烟测试覆盖范围，以及稳定／实验性工作流标记。 在发布证据文档中的现有绝对用户路径完成脱敏或规范化之前，此项检查会阻止 DOI 发布。

DOI 就绪的研究发布

TMCP 已准备好作为独立的软件方法学成果发布。有关可引用成果的边界、验证路径、数据可用性政策和声明限制，请参见 RESEARCH_READY.md 和 docs/release-notes/v0.3.3-doi.md。

参考资料

• 快速入门
• CLI
• 安装和软件包检查
• 分发
• 中央运行时
• 数据包稳定性
• 自适应数据包运行时
• 一级发布量规