artifact-chain-assistant 0.8.0

package/adapters/codex/templates/extended/governance/release_policy/starter.md

@@ -0,0 +1,131 @@
+---
+id: {RP_ID}
+title: {发布策略标题}
+status: draft
+version: {版本号}
+related_features: []
+related_decisions: []
+---
+
+# {RP_ID}: {发布策略标题}
+
+<!-- 本模板是插件 starter 指导，项目本地模板可完全覆盖 -->
+<!-- 插件模板是入门指导，项目本地模板是权威 -->
+
+## 概述
+
+{描述本发布策略的适用范围：哪些子包/产品、什么发布节奏、发布目标}
+
+## 版本语义
+
+- **主版本（major）**：{定义什么变更触发主版本号递增}
+- **次版本（minor）**：{定义什么变更触发次版本号递增}
+- **补丁版本（patch）**：{定义什么变更触发补丁版本递增}
+- **预发布标签**：{alpha/beta/rc 使用规则}
+
+## 发布节奏
+
+| 类型 | 频率 | 触发条件 | 说明 |
+|------|------|---------|------|
+| 常规发布 | {频率} | {条件} | {说明} |
+| 紧急发布 | {频率} | {条件} | {说明} |
+| 预发布 | {频率} | {条件} | {说明} |
+
+## 分支策略
+
+- **主分支**：{main/master 及其保护规则}
+- **发布分支**：{release 分支命名、生命周期、合并策略}
+- **热修复分支**：{hotfix 分支命名和流程}
+
+## 发布流程
+
+### 1. 准备阶段
+
+- [ ] 确认所有 CI 检查通过
+- [ ] 确认版本锁审计通过
+- [ ] 确认变更日志已更新
+- [ ] 确认依赖版本兼容
+
+### 2. 版本决策
+
+```bash
+# 确定版本号
+{版本决策命令或流程}
+```
+
+### 3. 构建与验证
+
+```bash
+# 全量构建
+{构建命令}
+
+# 测试验证
+{测试命令}
+
+# 验证命令
+{验证命令}
+```
+
+### 4. 发布执行
+
+```bash
+# 打标签
+{打标签命令}
+
+# 发布到注册中心
+{发布命令}
+```
+
+### 5. 发布后确认
+
+- [ ] 确认包已在注册中心可安装
+- [ ] 确认文档已更新
+- [ ] 确认下游项目已通知
+
+## 变更日志规范
+
+- 使用 {CHANGELOG 格式} 格式
+- 每个发布版本必须包含：新增功能、修复、破坏性变更
+- {附加的变更日志规则}
+
+## 合规要求
+
+- [ ] 许可证检查通过
+- [ ] 安全扫描通过
+- [ ] 第三方依赖审计通过（如适用）
+- {附加合规项}
+
+## 回滚策略
+
+### 回滚触发条件
+
+{描述什么情况下需要回滚发布}
+
+### 回滚步骤
+
+```bash
+# 撤销发布
+{回滚命令}
+```
+
+### 通知机制
+
+{回滚后的通知流程}
+
+## 适用范围
+
+- **子包/产品**：{列出本策略覆盖的子包或产品}
+- **排除项**：{列出不适用的情况}
+
+## 关联制品
+
+- 功能特性：{related_features}
+- 决策：{related_decisions}
+- 发布技能：{关联的 publish_skill 制品}
+- 合规制品：{关联的 oss_compliance 制品}
+
+## 变更日志
+
+| 日期 | 变更 | 作者 |
+|------|------|------|
+| {YYYY-MM-DD} | 初始版本 | {作者} |

package/adapters/codex/templates/extended/ops/deployment_manifest/review-checklist.md

@@ -0,0 +1,51 @@
+# Deployment Manifest 审查清单
+
+<!-- 本清单是插件通用基线，项目本地审查规则可覆盖 -->
+
+## 结构完整性
+
+- [ ] `id` 字段存在且符合项目 ID 模式（如 `DEP-{nnn}` 或环境名）
+- [ ] `title` 清晰描述部署范围
+- [ ] `environment` 已指定
+- [ ] 部署信息完整
+
+## 部署流程质量
+
+- [ ] 前置条件明确
+- [ ] 部署步骤可执行
+- [ ] 验证方法可行
+- [ ] 回滚计划完整
+
+## 资源配置
+
+- [ ] 资源规格合理
+- [ ] 环境变量完整
+- [ ] 配置与环境匹配
+- [ ] 敏感信息已加密
+
+## 健康检查
+
+- [ ] 存活检查已配置
+- [ ] 就绪检查已配置
+- [ ] 超时设置合理
+- [ ] 检查端点可访问
+
+## 回滚计划
+
+- [ ] 回滚触发条件明确
+- [ ] 回滚步骤可执行
+- [ ] 回滚验证方法可行
+- [ ] 回滚影响已评估
+
+## 监控与告警
+
+- [ ] 关键指标已识别
+- [ ] 告警阈值合理
+- [ ] 告警通知配置正确
+- [ ] 监控覆盖完整
+
+## 追溯性
+
+- [ ] 关联功能特性存在
+- [ ] 关联决策存在
+- [ ] 部署清单可追溯到版本

package/adapters/codex/templates/extended/ops/deployment_manifest/starter.md

@@ -0,0 +1,117 @@
+---
+id: {DEP_ID}
+title: {部署清单标题}
+status: draft
+environment: {prod/staging/dev}
+related_features: []
+related_decisions: []
+---
+
+# {DEP_ID}: {部署清单标题}
+
+<!-- 本模板是插件 starter 指导，项目本地模板可完全覆盖 -->
+<!-- 插件模板是入门指导，项目本地模板是权威 -->
+
+## 概述
+
+{描述这个部署清单的适用环境、部署目标和约束}
+
+## 部署信息
+
+- **环境**：{environment}
+- **版本**：{版本号}
+- **部署时间**：{计划时间}
+- **负责人**：{负责人}
+
+## 前置条件
+
+- [ ] 所有测试通过
+- [ ] 代码审查完成
+- [ ] 依赖服务就绪
+- [ ] 数据库迁移完成（如适用）
+
+## 部署步骤
+
+### 1. 准备阶段
+
+```bash
+# 备份当前版本
+{备份命令}
+
+# 验证镜像
+{验证命令}
+```
+
+### 2. 部署阶段
+
+```bash
+# 更新配置
+{配置更新命令}
+
+# 滚动更新
+{部署命令}
+```
+
+### 3. 验证阶段
+
+```bash
+# 健康检查
+{健康检查命令}
+
+# 功能验证
+{功能验证命令}
+```
+
+## 资源配置
+
+| 资源 | 规格 | 数量 | 说明 |
+|------|------|------|------|
+| CPU | {规格} | {数量} | {说明} |
+| 内存 | {规格} | {数量} | {说明} |
+| 存储 | {规格} | {数量} | {说明} |
+
+## 环境变量
+
+| 变量 | 值 | 描述 |
+|------|-----|------|
+| {变量1} | {值} | {描述} |
+| {变量2} | {值} | {描述} |
+
+## 健康检查
+
+| 检查项 | 端点 | 预期响应 | 超时 |
+|--------|------|---------|------|
+| 存活检查 | /healthz | 200 OK | 5s |
+| 就绪检查 | /ready | 200 OK | 10s |
+
+## 回滚计划
+
+### 回滚触发条件
+
+{描述什么情况下需要回滚}
+
+### 回滚步骤
+
+```bash
+# 回滚到上一版本
+{回滚命令}
+```
+
+### 回滚验证
+
+{验证回滚成功的方法}
+
+## 监控与告警
+
+### 关键指标
+
+| 指标 | 阈值 | 告警方式 |
+|------|------|---------|
+| 错误率 | < 1% | {告警方式} |
+| 延迟 | < 200ms | {告警方式} |
+
+## 变更日志
+
+| 日期 | 变更 | 作者 |
+|------|------|------|
+| {YYYY-MM-DD} | 初始版本 | {作者} |

package/adapters/codex/templates/extended/ops/migration_plan/review-checklist.md

@@ -0,0 +1,63 @@
+# Migration Plan 审查清单
+
+<!-- 本清单是插件通用基线，项目本地审查规则可覆盖 -->
+
+## 结构完整性
+
+- [ ] `id` 字段存在且符合项目 ID 模式（如 `MPLAN-{nnn}`）
+- [ ] `title` 清晰描述迁移范围
+- [ ] `scope` 已明确界定
+- [ ] 迁移策略已选择
+
+## 阶段划分
+
+- [ ] 阶段划分合理且相互独立
+- [ ] 每阶段有明确目标和交付物
+- [ ] 时间窗口现实可行
+- [ ] 验证标准可度量
+
+## 回滚方案
+
+- [ ] 每个阶段有明确回滚点
+- [ ] 回滚触发条件清晰
+- [ ] 回滚操作具体可执行
+- [ ] 回滚窗口已定义且合理
+
+## 数据迁移
+
+- [ ] 数据量已评估
+- [ ] 迁移方式已选择
+- [ ] 一致性保证策略已说明
+- [ ] 数据验证方案存在
+
+## 并行运行
+
+- [ ] 并行运行范围已定义
+- [ ] 数据同步方式已说明
+- [ ] 切换标准明确
+- [ ] 并行运行时长合理
+
+## 风险评估
+
+- [ ] 关键风险已识别
+- [ ] 概率和影响已评估
+- [ ] 缓解措施具体可行
+- [ ] 风险升级机制存在
+
+## 依赖管理
+
+- [ ] 关键依赖已识别
+- [ ] 依赖状态已跟踪
+- [ ] 依赖风险已评估
+
+## 沟通与验收
+
+- [ ] 沟通计划已制定
+- [ ] 验收标准明确可度量
+- [ ] 利益相关方已识别
+
+## 追溯性
+
+- [ ] 关联功能特性存在
+- [ ] 关联决策存在
+- [ ] 迁移计划可追溯到业务驱动因素

package/adapters/codex/templates/extended/ops/migration_plan/starter.md

@@ -0,0 +1,117 @@
+---
+id: {MPLAN_ID}
+title: {迁移计划标题}
+status: draft
+scope: {迁移范围}
+related_features: []
+related_decisions: []
+---
+
+# {MPLAN_ID}: {迁移计划标题}
+
+<!-- 本模板是插件 starter 指导，项目本地模板可完全覆盖 -->
+<!-- 插件模板是入门指导，项目本地模板是权威 -->
+
+## 概述
+
+{描述这次迁移的背景、目标、范围和预期收益}
+
+## 迁移信息
+
+- **迁移范围**：{scope}
+- **源状态**：{当前系统/架构/技术栈}
+- **目标状态**：{目标系统/架构/技术栈}
+- **迁移策略**：大爆炸 / 渐进式 / 绞杀者模式 / 并行运行
+- **预估工期**：{时间}
+- **负责人**：{负责人}
+
+## 迁移阶段
+
+### 阶段 1：{阶段名称}
+
+**目标**：{阶段目标}
+
+**交付物**：
+- [ ] {交付物 1}
+- [ ] {交付物 2}
+
+**时间窗口**：{开始时间} ~ {结束时间}
+
+**验证标准**：
+- {验证标准 1}
+- {验证标准 2}
+
+### 阶段 2：{阶段名称}
+
+**目标**：{阶段目标}
+
+**交付物**：
+- [ ] {交付物 1}
+- [ ] {交付物 2}
+
+**时间窗口**：{开始时间} ~ {结束时间}
+
+**验证标准**：
+- {验证标准 1}
+- {验证标准 2}
+
+## 回滚点定义
+
+| 阶段 | 回滚点 | 回滚触发条件 | 回滚操作 | 最大回滚窗口 |
+|------|--------|-------------|---------|-------------|
+| {阶段1} | {回滚点} | {条件} | {操作} | {时间} |
+| {阶段2} | {回滚点} | {条件} | {操作} | {时间} |
+
+## 数据迁移策略
+
+- **数据量评估**：{数据量}
+- **迁移方式**：全量 / 增量 / 双写
+- **一致性保证**：{一致性策略}
+- **验证方式**：{数据验证方法}
+
+## 并行运行期
+
+- **并行运行范围**：{哪些系统并行运行}
+- **数据同步方式**：{同步策略}
+- **切换标准**：{何时从旧系统切换到新系统}
+- **并行运行时长**：{预估时间}
+
+## 风险评估
+
+| 风险 | 概率 | 影响 | 缓解措施 |
+|------|------|------|---------|
+| {风险1} | 高/中/低 | 高/中/低 | {措施} |
+| {风险2} | 高/中/低 | 高/中/低 | {措施} |
+
+## 依赖关系
+
+| 依赖项 | 依赖类型 | 负责人 | 状态 |
+|--------|---------|--------|------|
+| {依赖1} | 前置条件 / 外部依赖 | {负责人} | 待就绪 / 已就绪 |
+| {依赖2} | 前置条件 / 外部依赖 | {负责人} | 待就绪 / 已就绪 |
+
+## 沟通计划
+
+| 事件 | 频率 | 参与者 | 渠道 |
+|------|------|--------|------|
+| 进度同步 | {频率} | {参与者} | {渠道} |
+| 风险评审 | {频率} | {参与者} | {渠道} |
+| 里程碑汇报 | {频率} | {参与者} | {渠道} |
+
+## 验收标准
+
+- [ ] {验收标准 1}
+- [ ] {验收标准 2}
+- [ ] {验收标准 3}
+
+## 关联制品
+
+- 功能特性：{related_features}
+- 决策：{related_decisions}
+- 设计文档：{related_designs}
+
+## 变更日志
+
+| 日期 | 变更 | 作者 |
+|------|------|------|
+| {YYYY-MM-DD} | 初始版本 | {作者} |

package/adapters/codex/templates/extended/ops/performance_budget/review-checklist.md

@@ -0,0 +1,50 @@
+# Performance Budget 审查清单
+
+<!-- 本清单是插件通用基线，项目本地审查规则可覆盖 -->
+
+## 结构完整性
+
+- [ ] `id` 字段存在且符合项目 ID 模式（如 `PERF-{nnn}`）
+- [ ] `title` 清晰描述预算范围
+- [ ] `scope` 已明确界定
+- [ ] 基线版本已标注
+
+## 指标定义质量
+
+- [ ] 响应时间指标包含 P50/P95/P99
+- [ ] 吞吐量目标合理且基于实际业务量
+- [ ] 资源使用上限合理且基于硬件能力
+- [ ] 错误率目标符合 SLA 要求
+
+## 测量方法
+
+- [ ] 测试工具和版本已指定
+- [ ] 测试场景覆盖关键路径
+- [ ] 并发数和数据量有代表性
+- [ ] 测量流程可复现
+
+## 回归检测
+
+- [ ] 回归阈值明确
+- [ ] CI 集成方案存在（如适用）
+- [ ] 手动审查触发条件清晰
+- [ ] 检测频率合理
+
+## 基线管理
+
+- [ ] 历史基线已记录
+- [ ] 基线更新流程已定义
+- [ ] 基线退化有告警机制
+
+## 可操作性
+
+- [ ] 超出预算时有排查指引
+- [ ] 优化方向有建议
+- [ ] 负责人已指定
+- [ ] 审查周期已设定
+
+## 追溯性
+
+- [ ] 关联功能特性存在
+- [ ] 关联决策存在
+- [ ] 性能预算可追溯到业务需求

package/adapters/codex/templates/extended/ops/performance_budget/starter.md

@@ -0,0 +1,117 @@
+---
+id: {PERF_ID}
+title: {性能预算标题}
+status: draft
+scope: {适用范围}
+related_features: []
+related_decisions: []
+---
+
+# {PERF_ID}: {性能预算标题}
+
+<!-- 本模板是插件 starter 指导，项目本地模板可完全覆盖 -->
+<!-- 插件模板是入门指导，项目本地模板是权威 -->
+
+## 概述
+
+{描述这个性能预算的适用范围、目标用户和业务背景}
+
+## 预算信息
+
+- **适用范围**：{scope}
+- **基线版本**：{当前基线版本}
+- **测量环境**：{测试环境描述}
+- **负责人**：{负责人}
+
+## 性能指标预算
+
+### 响应时间
+
+| 接口/操作 | P50 | P95 | P99 | 测量方法 |
+|-----------|-----|-----|-----|---------|
+| {接口1} | {ms} | {ms} | {ms} | {测量工具} |
+| {接口2} | {ms} | {ms} | {ms} | {测量工具} |
+
+### 吞吐量
+
+| 接口/操作 | 目标 QPS | 峰值 QPS | 测量方法 |
+|-----------|---------|---------|---------|
+| {接口1} | {QPS} | {QPS} | {测量工具} |
+| {接口2} | {QPS} | {QPS} | {测量工具} |
+
+### 资源使用
+
+| 资源 | 基线 | 预算上限 | 告警阈值 | 测量方法 |
+|------|------|---------|---------|---------|
+| CPU | {百分比} | {百分比} | {百分比} | {监控工具} |
+| 内存 | {MB} | {MB} | {MB} | {监控工具} |
+| 磁盘 IO | {MB/s} | {MB/s} | {MB/s} | {监控工具} |
+| 网络 IO | {Mbps} | {Mbps} | {Mbps} | {监控工具} |
+
+### 错误率
+
+| 接口/操作 | 目标错误率 | 告警阈值 | 测量方法 |
+|-----------|-----------|---------|---------|
+| {接口1} | {百分比} | {百分比} | {测量工具} |
+| 全局 | {百分比} | {百分比} | {测量工具} |
+
+## 回归检测策略
+
+### 自动化检测
+
+- **CI 集成**：{是否在 CI 中运行性能测试}
+- **回归阈值**：{指标退化超过多少百分比视为回归}
+- **检测频率**：{每次提交 / 每日 / 每周}
+
+### 手动审查触发条件
+
+- {触发条件 1}
+- {触发条件 2}
+
+## 测量方法
+
+### 测试工具
+
+| 工具 | 用途 | 版本 |
+|------|------|------|
+| {工具1} | {用途} | {版本} |
+| {工具2} | {用途} | {版本} |
+
+### 测试场景
+
+| 场景 | 并发数 | 持续时间 | 数据量 |
+|------|--------|---------|--------|
+| {场景1} | {并发数} | {时间} | {数据量} |
+| {场景2} | {并发数} | {时间} | {数据量} |
+
+### 测量流程
+
+1. {步骤 1}
+2. {步骤 2}
+3. {步骤 3}
+
+## 基线历史
+
+| 日期 | 版本 | P95 延迟 | QPS | 错误率 | 备注 |
+|------|------|---------|-----|--------|------|
+| {YYYY-MM-DD} | {版本} | {ms} | {QPS} | {百分比} | {备注} |
+
+## 优化指引
+
+当指标超出预算时的排查方向：
+
+- **延迟退化**：{排查步骤}
+- **吞吐下降**：{排查步骤}
+- **资源溢出**：{排查步骤}
+
+## 关联制品
+
+- 功能特性：{related_features}
+- 决策：{related_decisions}
+- 设计文档：{related_designs}
+
+## 变更日志
+
+| 日期 | 版本 | 变更 | 作者 |
+|------|------|------|------|
+| {YYYY-MM-DD} | v1 | 初始版本 | {作者} |

package/adapters/codex/templates/extended/ops/runbook/review-checklist.md

@@ -0,0 +1,51 @@
+# Runbook 审查清单
+
+<!-- 本清单是插件通用基线，项目本地审查规则可覆盖 -->
+
+## 结构完整性
+
+- [ ] `id` 字段存在且符合项目 ID 模式（如 `RUN-{nnn}`）
+- [ ] `title` 清晰描述运维场景
+- [ ] 适用场景已定义
+- [ ] 负责人已指定
+
+## 操作流程质量
+
+- [ ] 步骤清晰可执行
+- [ ] 命令准确无误
+- [ ] 预期结果明确
+- [ ] 验证方法可行
+
+## 告警与监控
+
+- [ ] 关键指标已识别
+- [ ] 告警阈值合理
+- [ ] 告警处理步骤明确
+- [ ] 监控覆盖完整
+
+## 回滚流程
+
+- [ ] 回滚触发条件明确
+- [ ] 回滚步骤可执行
+- [ ] 回滚验证方法可行
+- [ ] 回滚影响已评估
+
+## 故障排查
+
+- [ ] 常见问题已记录
+- [ ] 排查步骤清晰
+- [ ] 日志位置明确
+- [ ] 联系人信息完整
+
+## 追溯性
+
+- [ ] 关联功能特性存在
+- [ ] 关联决策存在
+- [ ] 运维手册可追溯到系统设计
+
+## 维护性
+
+- [ ] 手册易于更新
+- [ ] 步骤可验证
+- [ ] 最近执行日期已记录
+- [ ] 审核周期已设定