Bootstrap Agentic System
用途
该技能用于设计并按需安装一个仓库本地的智能体系统（Agentic System）。Bootstrap 只安装智能体系统文件，包括：指令、智能体、技能、提示词、治理文档、知识文档、产物模板、会话规则和维护溯源。
Bootstrap 不得实现应用功能、编辑产品代码、修改数据库模式或迁移、更改运行时配置，或创建产品测试。
使命
创建一个小型、耐用的智能体工作流，以预防仓库在规划、知识加载、实现交接、验证和维护中可能出现的代价高昂的失败。
生成的系统必须因仓库而异、经过审批把关、基于模板且可维护。除非用户在生成前明确批准更窄的系统，否则该系统必须包含 Planner、Implementor、Tester 或 Integration Tester、Knowledge Builder、Ask 和根指令。除非用户在生成前停止 Bootstrap，否则 Knowledge Builder 和 Ask 在第一批生成的智能体中为必需项。
保持 Bootstrap 为一个公开编排器。使用内部 scout 通道、决策登记、文件计划、批次审批和审计来保持工作流易理解；不要把初始面向用户的工作流拆分为多个公开入口点。
不可协商原则
当存在匹配模板时，始终从本技能文件夹中的公开 Bootstrap 模板生成。
将 templates/agents/、templates/skills/ 和 templates/instructions/ 视为规范模板镜像：先复制，填充已批准的占位符和槽位，剥离仅供源模板使用的槽位标记，并保留非槽位的规范措辞。
平台适配只能更改已声明的占位符值和工具/调用槽位。其余所有规范内容保持完全一致；原生注册适配器遵循 contracts/platform-compatibility.md。
生成的运行时文件不得包含 CANONICAL-TEMPLATE-SLOT 注释。这些标记仅用于源模板维护。
在 agentic-system manifest 中记录每一项生成、跳过、推迟、填充占位符、剥离标记和原生适配器决策。
写入文件前，先产出文件计划并等待明确批准。使用一个主计划，并在每个写入批次前请求批准，除非用户明确批准合并批次。
使用 PLATFORM_TOOLS 和已声明的调用槽位保留必需的基线操作；当目标平台支持时，保留委派智能体的 frontmatter。仅添加确切发现的或用户批准的 MCP 或平台工具。
生成的 Markdown 智能体中，每个 tools: frontmatter 项都必须是字符串。填充 "{{APPROVED_MCP_TOOLS}}" 时，将其替换为零个或多个带引号的精确工具名字符串，或在未批准额外工具时移除该占位符项。
应用 contracts/context-boundaries.md：创建项目根目录的 knowledge/，将运行时资源收集到一个运行时根目录下（默认 .agentic-system/），将安装/维护材料隔离到 .agentic-system-maintenance/ 或经批准的专用顶层根目录，并强制执行普通上下文排除。
保持上下文词汇表和知识索引相互独立。上下文词汇表存储稳定的仓库代码/领域词汇；知识索引控制任务特定的知识选择。
在生成的运行时契约中保持模式强制。增强的 Planner 模板已包含知识索引和计划模式路径的槽位；Bootstrap 必须在生成文件中填充并验证这些路径。Planner 还在其正文中承载澄清问题格式，因此任何生成文件都不得重述它。
保持根指令简短、导航性且对提示敏感。从 templates/instructions/AGENTS.md 生成它们。根指令必须路由到生成的智能体、技能、模式、知识索引、词汇表和相关时的提示特定部分；它们不得成为单体事实转储，也不得为每个请求重复完整的智能体契约。
将专门规则放入从 templates/instructions/*.instructions.md 生成的模块化指令文件中，通过所选平台经过验证的指令加载机制保留其声明的范围，而不是扩大根指令。
不要仅因为缺少 CONTEXT.md 就创建它。仅在稳定仓库词汇、真源边界或歧义术语已解决时，才创建或更新词汇表。
绝不在缺少维护基线的情况下交接生成的系统：答案文件、原始 .baseline/ 副本和 manifest 定制登记。
保持未来维护明确。Bootstrap 写入 manifest、answers、baseline 和 changelog 快照证据，以便 Maintainer 以后能对契约差异进行分类，而不是静默重写文件。
契约文件
本文件是路由器。加载你所在阶段的契约；不要一开始就全部加载。
契约 | 何时加载 contracts/source-model.md | 任何阶段，在读取模板或注册表之前。定义源资产和共享词汇。 contracts/discovery-and-decisions.md | 阶段 A-C：需求确认、受限发现、决策登记。 contracts/platform-compatibility.md | 所选环境研究、规范保留、原生注册和兼容性验证；与 Maintainer 共享。 contracts/context-boundaries.md | 项目知识、维护隔离、受保护发现、静态验证和旧版布局迁移；与 Maintainer 共享。 contracts/generation.md | 阶段 D-E：提案、文件计划、复制优先生成、维护基线写入。 contracts/audit-and-handoff.md | 阶段 F-H：模式强制、契约审计、维护交接。
Bootstrap 阶段
按顺序运行阶段。每个条目说明该阶段的目的及其治理契约。
阶段 A，需求确认与范围：确认请求属于智能体系统工作，并捕获目标仓库、所选环境、执行主机、语言、前缀、风险和是否需要生成。参见 contracts/discovery-and-decisions.md。
阶段 B，受限发现：运行只读发现通道，并产出候选工具和集成矩阵。参见 contracts/discovery-and-decisions.md。
阶段 C，决策登记：由 registry/placeholders.yaml 和 registry/capabilities.yaml 驱动，每次一个问题地解决每项必需决策。参见 contracts/discovery-and-decisions.md。
阶段 D，提案与文件计划：产出提案、文件计划和批次审批检查点。批准默认为 false。参见 contracts/generation.md。
阶段 E，复制优先生成：从镜像应用已批准的批次，然后写入答案文件、原始基线副本和定制登记。参见 contracts/generation.md。
阶段 F，运行时模式与知识强制：验证生成的 Planner 引用知识索引和计划模式路径，并保留自己的澄清格式。参见 contracts/audit-and-handoff.md。
阶段 G，契约审计与验证：运行完整的生成系统检查清单，并将缺失的必需元素视为阻塞项。参见 contracts/audit-and-handoff.md。
阶段 H，维护交接：报告证据、路径、推迟的决策、风险以及 Bootstrap 后的建议。参见 contracts/audit-and-handoff.md。
输出形态
写入前：输出提案和未经批准的文件计划，然后请求明确批准。
写入后：输出已更改文件、验证结果、Bootstrap 契约对齐情况、manifest、answers、baseline 和 changelog 快照路径、Bootstrap 后建议以及剩余风险。