关于 bootstrap
用于补齐明确要求且缺失的 AgentOps 入口文档,且不会覆盖已有文件。适合需要严格控制仓库设置范围、避免擅自推断内容的场景。
主要功能
- 01检查已有规范文件
- 02仅创建明确要求的缺失文档
- 03保留已有文件不变
- 04按需创建裁决存储目录
- 05报告已创建、跳过和失败路径
适用场景
- 01补充缺失的 PRODUCT.md 和 GOALS.md
- 02设置时保留已有的 AGENTS.md
- 03创建明确要求的持久裁决存储
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ boshu2/ agentops --skill bootstrap安装后在 Claude Code 中输入/bootstrap确认已加载。
附带文件references/context-routing.mdreferences/examples.md
详细介绍
Bootstrap — 最小化项目设置
Bootstrap 仅补充明确请求但缺失的 AgentOps 入口文档,并在有请求时创建持久化判定目录。它不会初始化 Git、安装钩子、创建跟踪器状态、启动运行时,也不会强加交付工作流。
永不覆盖是让 Bootstrap 可以安全地在任何仓库中运行的关键:只能添加内容的设置步骤天然具有幂等性;可能替换内容的步骤则必须先证明它理解将要替换的内容。
命名失败模式——脚手架泛滥:因为觉得“完整”的设置更有帮助,就创建调用者从未请求的文件。
反模式:从目录名称和 README 推断产品意图,以免向调用者提问。纠正方式:询问缺失的内容;自信地写出错误的 PRODUCT.md 比提出问题更糟。
提示词
Bootstrap missing AgentOps docs for fleet-router (ao is installed). Create only PRODUCT.md and GOALS.md since they're missing; AGENTS.md already exists, so leave it untouched. Also create .agents/ao/verdicts/sha256/. Report created, skipped, and failed paths.
成功标准
- 报告列出已创建的
PRODUCT.md和GOALS.md,并将已存在的AGENTS.md列为已跳过。 - 如果路径与现有文档冲突,例如
AGENTS.md已存在,应报告为已跳过,而不是覆盖。 - 只有在调用者明确请求持久化判定存储时,才创建
.agents/ao/verdicts/sha256/。 - 报告结尾仅列出已创建、已跳过和失败的路径,不包含后续操作或
git命令。
流程
- 检查目标目录,并报告哪些规范文件已存在。
- 如果无法安全推断缺失的产品意图或目标内容,请向调用者询问。
- 仅创建明确请求且缺失的文件。绝不覆盖现有文档。
- 如果请求持久化本地判定存储,则创建
.agents/ao/verdicts/sha256/。 - 验证文件系统中的文件是否存在,并报告已创建、已跳过和失败的路径。
- 停止。
常见文档包括 PRODUCT.md、GOALS.md、AGENTS.md,以及说明 RPI 遍历方式的 README 章节。生成的产品文案从运营层类别开始,并保留所有权边界。仓库仍可自由采用自己的 Git、CI、跟踪器、发布和部署策略。
命名。 三个界面都使用“bootstrap”一词,但彼此不同。本技能负责撰写缺失的入口文档。ao init 是创建本地证据和判定目录(.agents/ao/**)的 CLI 命令。ao session bootstrap 是只读会话命令,用于报告哪些本地概览文件已存在。本技能不会调用其中任何一个。
对于选定的 CDLC,调用者通过上下文路由参考解析现有外部存储。Bootstrap 绝不会创建使用方项目配置,也不会创建替代的知识或撤回来源。新的 CDLC 证明使用明确选定的外部证据根目录;上述本地判定目录方案适用于调用者请求的独立证明。
非目标
- 安装或调用
ao、br、bd、NTM、Agent Mail 或其他运行时; - 创建
.git、工作树、分支、提交、钩子或 CI 工作流; - 选择工作,或声称仓库设置已完成(实际检查过的路径除外);
- 自动运行 RPI。
输出
返回目标路径、请求的文件、已创建的文件、原样保留的现有文件、写入失败情况和验证观察结果。不要包含后续操作。