菜单
根据代码、Ansible、Helm chart、验证脚本和现有设计文档,更新 `docs/00_设计文档/` 下受影响的 Markdown 文档。Use when a design change, deployment flow change, middleware change, runtime dependency change, or documentation correction should land in one or more design docs.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
Use when executing or verifying the AnyBackup Agent release deployment flow with KWeaver Core, Foundation, sandbox, V9 infra, and business services.
Use when an Agent must design user-visible AG-UI Markdown constraints before ag-ui-response publishes MQ, including layout, components, semantic labels, thought summaries, tool-call presentation, results, errors, clarification, and hidden-content boundaries.
Use when an Agent must produce user-visible Markdown and wrap it into the Decision Agent MQ field payload.ag_ui.
当用户需要通过 `foundation-cli api` 访问暂时没有标准业务命令覆盖的 Foundation REST API，或者用户直接给出原始路径、HTTP 方法、查询参数或请求体时使用。
当用户需要通过 `foundation-cli client` 执行客户端部署、部署历史、客户端清单、Runner、数据源、部署配置或部署日志相关命令时使用。
当用户需要通过 `foundation-cli host` 执行主机列表、主机保护对象、备份配置或主机恢复相关命令时使用。
基于 SOC 职业分类
| name | design-doc-change-handler |
| description | 根据代码、Ansible、Helm chart、验证脚本和现有设计文档,更新 `docs/00_设计文档/` 下受影响的 Markdown 文档。Use when a design change, deployment flow change, middleware change, runtime dependency change, or documentation correction should land in one or more design docs. |
把设计变更准确落到 docs/00_设计文档/ 的具体文档里,优先维护现有文件,只在必要时新增设计文档。
先确认设计结论来自哪里:
ansible/ 里的安装顺序、变量、前置检查。helm-chart/ 里的组件、依赖、环境变量和 Service 命名。scripts/validate_deploy.py 与 docs/操作文档/cluster-smoke.sh 里的验证口径。docs/00_设计文档/ 里的旧结论。只在能找到代码或脚本事实支撑时,再把它写进正式设计文档。
按内容落位:
00_V9部署总体架构设计.md。如果一个变更跨了两类以上内容,优先维护主文档,再同步辅文档。
design-diagram-maintainer 或至少标记需要补图。修改正文后,同步检查:
如果改动触及以下内容,补跑:
python scripts/validate_deploy.py --mode regression
触发条件:
install.shansible/helm-chart/foundation/init-scripts/docs/操作文档/cluster-smoke.shscripts/validate_deploy.py