artifact-chain-assistant 0.8.0

package/templates/extended/governance/oss_compliance/starter.md

@@ -0,0 +1,84 @@
+---
+id: {OSS_ID}
+title: {开源合规标题}
+status: draft
+version: {版本号}
+related_features: []
+related_decisions: []
+---
+
+# {OSS_ID}: {开源合规标题}
+
+<!-- 本模板是插件 starter 指导，项目本地模板可完全覆盖 -->
+<!-- 插件模板是入门指导，项目本地模板是权威 -->
+
+## 概述
+
+{描述本开源合规制品覆盖的仓库、包、发布目标和合规边界}
+
+## 许可证策略
+
+- **项目许可证**：{例如 Apache-2.0}
+- **允许的依赖许可证**：{列出允许范围}
+- **需要人工审查的许可证**：{列出触发审查的许可证}
+- **禁止的许可证**：{列出禁止范围和原因}
+
+## 第三方依赖审查
+
+| 依赖 | 版本 | 许可证 | 用途 | 审查结论 |
+|------|------|--------|------|----------|
+| {依赖名} | {版本} | {许可证} | {用途} | {通过/需修复/阻塞} |
+
+## 发布文件清单
+
+- [ ] `LICENSE`
+- [ ] `NOTICE`（如适用）
+- [ ] `README.md`
+- [ ] `CHANGELOG.md`
+- [ ] `SECURITY.md`
+- [ ] `CONTRIBUTING.md`
+- [ ] `CODE_OF_CONDUCT.md`
+- [ ] 包元数据中的 license/repository/homepage 字段
+
+## 源码与制品排除
+
+### 不应发布的内容
+
+- 父工程私有制品或内部规划文档
+- 本机绝对路径
+- 私有 token、密钥、凭据或内部 URL
+- 未授权的第三方素材
+- {项目特定排除项}
+
+### 发布前检查
+
+```bash
+{许可证检查命令}
+{依赖审计命令}
+{发布产物验证命令}
+```
+
+## 安全与披露
+
+- **安全报告入口**：{SECURITY.md 或联系渠道}
+- **漏洞披露流程**：{接收、确认、修复、发布公告}
+- **敏感信息扫描**：{扫描工具和门禁}
+
+## 合规例外
+
+| 例外项 | 原因 | 审批人 | 到期时间 | 后续动作 |
+|--------|------|--------|----------|----------|
+| {例外} | {原因} | {审批人} | {YYYY-MM-DD} | {动作} |
+
+## 关联制品
+
+- 功能特性：{related_features}
+- 决策：{related_decisions}
+- 发布策略：{关联的 release_policy 制品}
+- 发布技能：{关联的 publish_skill 制品}
+
+## 变更日志
+
+| 日期 | 变更 | 作者 |
+|------|------|------|
+| {YYYY-MM-DD} | 初始版本 | {作者} |

package/templates/extended/governance/publish_skill/review-checklist.md

@@ -0,0 +1,58 @@
+# Publish Skill 审查清单
+
+<!-- 本清单是插件通用基线，项目本地审查规则可覆盖 -->
+
+## 结构完整性
+
+- [ ] `id` 字段存在且符合项目 ID 模式（如 `PS-{nnn}`）
+- [ ] `title` 清晰描述发布技能功能
+- [ ] 触发条件明确
+- [ ] 适用包/产品已列出
+
+## 发布目标质量
+
+- [ ] 发布目标注册中心已明确
+- [ ] 认证方式已定义
+- [ ] 多目标发布策略已定义（如适用）
+- [ ] 发布目标与项目实际一致
+
+## 前置验证
+
+- [ ] 质量门禁检查项完整
+- [ ] 合规门禁检查项已定义（如适用）
+- [ ] 门禁检查顺序合理
+- [ ] 门禁失败的处理方式已定义
+
+## 发布流程质量
+
+- [ ] 发布步骤可执行
+- [ ] 每步有明确目的
+- [ ] 命令可直接运行或有明确替换指引
+- [ ] 发布后验证步骤完整
+
+## 输入/输出契约
+
+- [ ] 必需输入参数完整
+- [ ] 参数类型和描述明确
+- [ ] 输出格式定义完整（成功和失败）
+- [ ] 错误码有标准分类
+
+## 错误处理
+
+- [ ] 常见错误有处理方案
+- [ ] 认证失败有明确排查指引
+- [ ] 网络错误有重试策略
+- [ ] 版本冲突有处理方案
+
+## 追溯性
+
+- [ ] 关联功能特性存在
+- [ ] 关联决策存在
+- [ ] 关联发布策略存在
+- [ ] 发布技能可追溯到治理需求
+
+## 可测试性
+
+- [ ] 发布流程可在沙箱/测试环境验证
+- [ ] 示例输入/输出完整
+- [ ] 回滚流程已定义

package/templates/extended/governance/publish_skill/starter.md

@@ -0,0 +1,172 @@
+---
+id: {PS_ID}
+title: {发布技能标题}
+status: draft
+related_features: []
+related_decisions: []
+---
+
+# {PS_ID}: {发布技能标题}
+
+<!-- 本模板是插件 starter 指导，项目本地模板可完全覆盖 -->
+<!-- 插件模板是入门指导，项目本地模板是权威 -->
+
+## 概述
+
+{描述这个发布技能的用途：自动化发布哪些包到哪些注册中心，解决什么发布问题}
+
+## 技能元信息
+
+- **名称**：{skill_name}
+- **描述**：{description}
+- **触发条件**：{什么操作触发发布技能}
+- **适用包/产品**：{列出覆盖的包或产品}
+
+## 发布目标
+
+| 目标 | 注册中心 | 认证方式 | 说明 |
+|------|---------|---------|------|
+| {target1} | {registry} | {auth} | {说明} |
+| {target2} | {registry} | {auth} | {说明} |
+
+## 前置验证
+
+### 质量门禁
+
+- [ ] 所有测试通过
+- [ ] 代码审查完成
+- [ ] 版本锁审计通过
+- [ ] 制品验证通过
+- {附加门禁项}
+
+### 合规门禁
+
+- [ ] 许可证检查通过
+- [ ] 安全扫描通过（如适用）
+- [ ] 第三方依赖审计通过（如适用）
+
+## 发布流程
+
+### 1. 准备
+
+**目的**：{步骤目的}
+
+```bash
+# 验证工作区干净
+{验证命令}
+
+# 运行质量门禁
+{门禁命令}
+```
+
+### 2. 版本确定
+
+**目的**：{步骤目的}
+
+```bash
+# 版本号确定
+{版本命令}
+```
+
+### 3. 构建产物
+
+**目的**：{步骤目的}
+
+```bash
+# 构建
+{构建命令}
+
+# 验证产物
+{验证命令}
+```
+
+### 4. 发布执行
+
+**目的**：{步骤目的}
+
+```bash
+# 发布到目标
+{发布命令}
+```
+
+### 5. 发布后验证
+
+**目的**：{步骤目的}
+
+```bash
+# 安装验证
+{安装验证命令}
+
+# 功能验证
+{功能验证命令}
+```
+
+### 6. 记录与通知
+
+- [ ] 更新变更日志
+- [ ] 打 Git 标签
+- [ ] 通知下游（如适用）
+- [ ] 更新发布记录
+
+## 输入契约
+
+### 必需输入
+
+| 参数 | 类型 | 描述 |
+|------|------|------|
+| {param1} | {type} | {描述} |
+| {param2} | {type} | {描述} |
+
+### 可选输入
+
+| 参数 | 类型 | 默认值 | 描述 |
+|------|------|--------|------|
+| {param3} | {type} | {默认值} | {描述} |
+
+## 输出契约
+
+### 成功输出
+
+```json
+{
+  "success": true,
+  "package": "{包名}",
+  "version": "{版本号}",
+  "target": "{注册中心}"
+}
+```
+
+### 失败输出
+
+```json
+{
+  "success": false,
+  "error": {
+    "code": "PUBLISH_FAILED",
+    "message": "错误描述",
+    "stage": "失败阶段"
+  }
+}
+```
+
+## 错误处理
+
+| 错误码 | 描述 | 处理方式 |
+|--------|------|---------|
+| AUTH_FAILED | 认证失败 | 检查凭据配置 |
+| VERSION_CONFLICT | 版本冲突 | 确认版本号 |
+| GATE_FAILED | 质量门禁未通过 | 修复后重试 |
+| NETWORK_ERROR | 网络错误 | 重试或手动发布 |
+
+## 关联制品
+
+- 功能特性：{related_features}
+- 决策：{related_decisions}
+- 发布策略：{关联的 release_policy 制品}
+- 合规制品：{关联的 oss_compliance 制品}
+
+## 变更日志
+
+| 日期 | 变更 | 作者 |
+|------|------|------|
+| {YYYY-MM-DD} | 初始草稿 | {作者} |

package/templates/extended/governance/release_policy/review-checklist.md

@@ -0,0 +1,57 @@
+# Release Policy 审查清单
+
+<!-- 本清单是插件通用基线，项目本地审查规则可覆盖 -->
+
+## 结构完整性
+
+- [ ] `id` 字段存在且符合项目 ID 模式（如 `RP-{nnn}`）
+- [ ] `title` 清晰描述发布策略范围
+- [ ] `version` 已指定
+- [ ] 适用范围明确
+
+## 版本策略质量
+
+- [ ] 主/次/补丁版本递增规则清晰
+- [ ] 预发布标签使用规则已定义
+- [ ] 版本策略与项目实际发布流程一致
+- [ ] 破坏性变更有明确识别标准
+
+## 发布流程质量
+
+- [ ] 发布步骤可执行
+- [ ] 构建与验证命令完整
+- [ ] 发布后确认清单完整
+- [ ] 准备阶段检查项覆盖关键质量门禁
+
+## 分支与节奏
+
+- [ ] 分支策略与团队实际工作流匹配
+- [ ] 发布节奏合理（不过频也不过疏）
+- [ ] 紧急发布流程有明确触发条件
+- [ ] 分支保护规则已定义
+
+## 变更日志规范
+
+- [ ] 变更日志格式已指定
+- [ ] 必须包含的变更类别已定义
+- [ ] 变更日志更新是发布流程的门禁步骤
+
+## 合规要求
+
+- [ ] 许可证检查流程已定义
+- [ ] 安全扫描流程已定义（如适用）
+- [ ] 第三方依赖审计已定义（如适用）
+- [ ] 合规要求与项目类型匹配
+
+## 回滚策略
+
+- [ ] 回滚触发条件明确
+- [ ] 回滚步骤可执行
+- [ ] 回滚通知机制已定义
+- [ ] 回滚影响已评估
+
+## 追溯性
+
+- [ ] 关联功能特性存在
+- [ ] 关联决策存在
+- [ ] 发布策略可追溯到治理需求

package/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/templates/extended/ops/deployment_manifest/review-checklist.md

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

package/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} | 初始版本 | {作者} |