bootstrap-agentic-system

Bootstrap Agentic System

使用此技能设计一个可选安装在仓库本地的 Agentic System。Bootstrap 仅安装 Agent 系统文件：指令、Agent、技能、提示词、治理文档、知识文档、产物模板、会话规则和维护来源信息。

Bootstrap 不得实现应用功能、编辑产品代码、修改数据库架构或迁移、变更运行时配置，也不得创建产品测试。

使命

创建一套精简、持久的 Agent 工作流，防止仓库在规划、知识加载、实现交接、验证和维护方面可能出现的高代价失败。

生成的系统必须针对特定仓库、以审批为门槛、由模板提供支持且易于维护。除非用户在生成前明确批准采用范围更窄的系统，否则系统必须包含 Planner、Implementor、Tester 或 Integration Tester、Knowledge Builder、Ask，以及根目录指令。Knowledge Builder 和 Ask 必须包含在首批生成的 Agent 中，除非用户在生成前停止 Bootstrap。

Bootstrap 应保持为单一的公共编排器。使用内部侦察通道、决策登记表、文件计划、批次审批和审计，让工作流易于理解；不要将面向用户的初始工作流拆分为多个独立入口。

不可妥协的原则

• 只要此技能文件夹中存在匹配的模板，就必须基于公开的 Bootstrap 模板生成。
• 将 templates/agents/、templates/skills/ 和 templates/instructions/ 视为规范模板镜像：先复制，再填入获准的占位符和插槽，移除仅用于源文件的插槽标记，并保留规范原文中非插槽部分的措辞。
• 平台适配只能更改声明的占位符值和工具／调用插槽。所有其他规范内容都必须保持原样；原生注册适配器须遵循 contracts/platform-compatibility.md。
• 生成的运行时文件不得包含 CANONICAL-TEMPLATE-SLOT 注释。这些标记仅用于维护源模板。
• 在 Agentic System 清单中记录每项生成、跳过、延期、占位符填充、标记移除和原生适配器决策。
• 写入文件前，先制定文件计划并等待明确批准。使用一份主计划，并在每批写入前征求批准，除非用户明确批准合并批次。
• 使用 PLATFORM_TOOLS 和声明的调用插槽保留必需的基础操作；如果目标平台支持委派 Agent 的 frontmatter，也须予以保留。只添加明确发现的或经用户批准的 MCP 或平台工具。
• 生成的 Markdown Agent 中，tools: frontmatter 的每一项都必须是字符串。填入 "{{APPROVED_MCP_TOOLS}}" 时，须将其替换为零个或多个精确引用的工具名称字符串；如果没有其他获批工具，则移除该占位符项。
• 应用 contracts/context-boundaries.md：在项目根目录创建 knowledge/，将运行时资源集中到一个运行时根目录（默认为 .agentic-system/），将安装／维护材料隔离在 .agentic-system-maintenance/ 或经批准的专用顶层目录中，并强制执行普通上下文排除规则。
• 将上下文术语表与知识索引分开。上下文术语表用于存储稳定的代码库代码／领域词汇；知识索引用于控制针对具体任务的知识选择。
• 在生成的运行时契约中保留架构强制校验。增强版 Planner 模板已包含知识索引和计划架构路径的插槽；Bootstrap 必须在生成的文件中填入并验证这些路径。Planner 正文中也包含澄清问题的格式，因此任何生成文件都不得再次说明该格式。
• 保持根指令简短、便于导航，并对提示词保持敏感。使用 templates/instructions/AGENTS.md 生成根指令。相关时，根指令必须指向生成的 Agent、技能、架构、知识索引、术语表和特定提示词的分段内容；不得将其变成冗长的事实汇总，也不得针对每个请求重复完整的 Agent 契约。
• 将专门规则放入由 templates/instructions/*.instructions.md 生成的模块化指令文件中，并通过所选平台经过验证的指令加载机制保留其声明范围，而不是扩充根指令。
• 不要仅仅因为缺少 CONTEXT.md 就创建该文件。只有在稳定的代码库词汇、事实来源边界或有歧义的术语得到确认后，才创建或更新术语表。
• 交付生成的系统时，绝不能缺少其维护基线：答案文件、原始 .baseline/ 副本以及清单自定义登记表。
• 明确记录后续维护要求。Bootstrap 会写入清单、答案、基线和变更日志快照证据，以便 Maintainer 对之后的契约差异进行分类，而不是悄悄重写文件。

合约文件

此文件是路由文件。加载当前阶段对应的合约；不要一开始就全部加载。

合约	加载时机
contracts/source-model.md	任何阶段，在读取模板或注册表之前。定义源资产和共享词汇。
contracts/discovery-and-decisions.md	阶段 A-C：接收需求、有限范围的发现、决策登记表。
contracts/platform-compatibility.md	所选环境研究、规范化保留、本机注册和兼容性验证；与维护者共用。
contracts/context-boundaries.md	项目知识、维护隔离、受限发现、静态验证和旧版布局迁移；与维护者共用。
contracts/generation.md	阶段 D-E：提案、文件计划、复制优先生成、维护基线写入。
contracts/audit-and-handoff.md	阶段 F-H：架构强制执行、合约审计、维护交接。

引导阶段

按顺序执行各阶段。每项都说明了阶段目的及其适用的合约。

• 阶段 A，需求接收与范围界定：确认请求属于 Agent 系统工作，并记录目标仓库、所选环境、执行主机、语言、前缀、风险以及是否需要生成。参见 contracts/discovery-and-decisions.md。
• 阶段 B，有限范围的发现：运行只读发现流程，并生成候选工具和集成矩阵。参见 contracts/discovery-and-decisions.md。
• 阶段 C，决策登记表：依据 registry/placeholders.yaml 和 registry/capabilities.yaml，逐个问题解决所有必需的决策。参见 contracts/discovery-and-decisions.md。
• 阶段 D，提案与文件计划：生成提案、文件计划和批次审批检查点。默认不予批准。参见 contracts/generation.md。
• 阶段 E，复制优先生成：从镜像应用获批批次，然后写入答案文件、原始基线副本和自定义登记表。参见 contracts/generation.md。
• 阶段 F，运行时架构与知识强制执行：验证生成的 Planner 引用了知识索引和计划架构路径，并保留其自身的澄清格式。参见 contracts/audit-and-handoff.md。
• 阶段 G，合约审计与验证：运行完整的生成系统检查清单，并将缺少必需元素视为阻塞问题。参见 contracts/audit-and-handoff.md。
• 阶段 H，维护交接：报告证据、路径、未决决策、风险和引导后的建议。参见 contracts/audit-and-handoff.md。

输出格式

写入之前：输出提案和未获批准的文件计划，然后请求明确批准。

写入之后：输出已更改的文件、验证结果、Bootstrap 合约一致性、清单、答案、基线和变更日志快照路径、引导后的建议以及剩余风险。