artifact-chain-assistant 0.8.0

package/adapters/codex/templates/extended/domain/database_migration/starter.md

@@ -0,0 +1,115 @@
+---
+id: {MIG_ID}
+title: {迁移标题}
+status: draft
+database: {数据库名称}
+related_features: []
+related_data_contracts: []
+---
+
+# {MIG_ID}: {迁移标题}
+
+<!-- 本模板是插件 starter 指导，项目本地模板可完全覆盖 -->
+<!-- 插件模板是入门指导，项目本地模板是权威 -->
+
+## 概述
+
+{描述这个数据库迁移的业务背景、影响范围和目标状态}
+
+## 迁移信息
+
+- **数据库**：{database}
+- **迁移类型**：DDL / DML / 混合
+- **影响表**：{受影响的表名}
+- **预估数据量**：{行数或数据大小}
+- **预估执行时间**：{时间}
+- **负责人**：{负责人}
+
+## 变更内容
+
+### Schema 变更
+
+```sql
+-- 正向迁移
+{SQL 语句}
+```
+
+| 变更对象 | 变更类型 | 说明 |
+|---------|---------|------|
+| {表名} | CREATE / ALTER / DROP | {变更描述} |
+| {索引名} | CREATE / DROP | {变更描述} |
+
+### 数据迁移
+
+```sql
+-- 数据迁移（如适用）
+{数据迁移 SQL}
+```
+
+- **迁移策略**：{在线迁移 / 停机迁移 / 双写}
+- **批次大小**：{每批处理行数}
+- **并发度**：{并发线程数}
+
+## 回滚方案
+
+### 回滚 SQL
+
+```sql
+-- 回滚迁移
+{回滚 SQL 语句}
+```
+
+### 回滚条件
+
+- **触发条件**：{什么情况下需要回滚}
+- **数据安全**：{回滚是否会导致数据丢失}
+- **回滚窗口**：{多长时间内可回滚}
+
+## 兼容性分析
+
+### 应用兼容性
+
+- **向前兼容**：{旧版应用能否在迁移后正常运行}
+- **向后兼容**：{新版应用能否在迁移前正常运行}
+- **停机要求**：{是否需要停机维护窗口}
+
+### 数据兼容性
+
+- **字段默认值**：{新增字段的默认值策略}
+- **NOT NULL 约束**：{如何处理现有空数据}
+- **外键约束**：{新增约束的验证策略}
+
+## 性能影响
+
+- **锁策略**：{表锁 / 行锁 / 无锁 DDL}
+- **索引影响**：{是否需要重建索引}
+- **IO 影响**：{预估 IO 负载}
+- **监控指标**：{迁移期间需要关注的指标}
+
+## 验证方案
+
+### 迁移前验证
+
+- [ ] 备份已创建
+- [ ] 测试环境已验证
+- [ ] 回归测试通过
+- [ ] 回滚方案已验证
+
+### 迁移后验证
+
+- [ ] Schema 变更正确
+- [ ] 数据完整性校验通过
+- [ ] 应用功能正常
+- [ ] 性能基线未退化
+
+## 关联制品
+
+- 功能特性：{related_features}
+- 数据契约：{related_data_contracts}
+- 设计文档：{related_designs}
+
+## 变更日志
+
+| 日期 | 版本 | 变更 | 作者 |
+|------|------|------|------|
+| {YYYY-MM-DD} | v1 | 初始版本 | {作者} |

package/adapters/codex/templates/extended/domain/domain_model/review-checklist.md

@@ -0,0 +1,43 @@
+# Domain Model 审查清单
+
+<!-- 本清单是插件通用基线，项目本地审查规则可覆盖 -->
+
+## 结构完整性
+
+- [ ] `id` 字段存在且符合项目 ID 模式（如 `DM-{nnn}` 或实体名）
+- [ ] `title` 清晰描述领域模型
+- [ ] 领域上下文已定义
+- [ ] 通用语言已建立
+
+## 领域设计质量
+
+- [ ] 聚合边界清晰
+- [ ] 聚合根职责单一
+- [ ] 实体和值对象区分正确
+- [ ] 不变量已定义且可验证
+
+## 事件设计
+
+- [ ] 领域事件已识别
+- [ ] 事件触发条件明确
+- [ ] 事件消费者已识别
+- [ ] 事件命名符合通用语言
+
+## 服务设计
+
+- [ ] 领域服务职责明确
+- [ ] 服务接口定义完整
+- [ ] 仓储接口抽象合理
+- [ ] 无循环依赖
+
+## 追溯性
+
+- [ ] 关联功能特性存在
+- [ ] 关联决策存在
+- [ ] 领域模型可追溯到业务需求
+
+## 实现一致性
+
+- [ ] 与实现代码一致
+- [ ] 领域模型可落地为代码
+- [ ] 测试覆盖核心逻辑

package/adapters/codex/templates/extended/domain/domain_model/starter.md

@@ -0,0 +1,83 @@
+---
+id: {DM_ID}
+title: {领域模型名称}
+status: draft
+related_features: []
+related_decisions: []
+---
+
+# {DM_ID}: {领域模型名称}
+
+<!-- 本模板是插件 starter 指导，项目本地模板可完全覆盖 -->
+<!-- 插件模板是入门指导，项目本地模板是权威 -->
+
+## 概述
+
+{描述这个领域模型的业务背景、核心概念和限界上下文}
+
+## 领域上下文
+
+- **限界上下文**：{上下文名称}
+- **通用语言**：{领域术语定义}
+- **上下文映射**：{与其他上下文的关系}
+
+## 聚合设计
+
+### 聚合根：{AggregateRoot}
+
+**职责**：{聚合根的核心职责}
+
+**实体**：
+- {Entity1}：{职责描述}
+- {Entity2}：{职责描述}
+
+**值对象**：
+- {ValueObject1}：{描述}
+- {ValueObject2}：{描述}
+
+### 聚合边界
+
+{描述聚合的边界和一致性规则}
+
+## 领域事件
+
+| 事件名称 | 触发条件 | 消费者 |
+|---------|---------|--------|
+| {Event1} | {条件} | {消费者} |
+| {Event2} | {条件} | {消费者} |
+
+## 不变量
+
+| 不变量 | 描述 | 验证方式 |
+|--------|------|---------|
+| {Invariant1} | {描述} | {验证方法} |
+| {Invariant2} | {描述} | {验证方法} |
+
+## 领域服务
+
+### {DomainService1}
+
+**职责**：{服务职责}
+**接口**：{主要方法}
+
+## 仓储接口
+
+### {Repository1}
+
+**职责**：{仓储职责}
+**方法**：
+- `findById(id)`: {描述}
+- `save(entity)`: {描述}
+- `findBySpecification(spec)`: {描述}
+
+## 关联制品
+
+- 功能特性：{related_features}
+- 决策：{related_decisions}
+- 设计文档：{related_designs}
+
+## 变更日志
+
+| 日期 | 变更 | 作者 |
+|------|------|------|
+| {YYYY-MM-DD} | 初始草稿 | {作者} |

package/adapters/codex/templates/extended/governance/oss_compliance/review-checklist.md

@@ -0,0 +1,51 @@
+# OSS Compliance 审查清单
+
+<!-- 本清单是插件通用基线，项目本地审查规则可覆盖 -->
+
+## 结构完整性
+
+- [ ] `id` 字段存在且符合项目 ID 模式（如 `OSS-{nnn}`）
+- [ ] `title` 清晰描述合规范围
+- [ ] 适用仓库、包或发布目标明确
+- [ ] 关联的发布策略或发布技能已记录
+
+## 许可证策略
+
+- [ ] 项目许可证明确
+- [ ] 允许、需审查和禁止的依赖许可证范围明确
+- [ ] 许可证策略与发布目标一致
+- [ ] 许可证异常有审批和到期机制
+
+## 依赖审查
+
+- [ ] 第三方依赖清单完整
+- [ ] 每个依赖的许可证和用途已记录
+- [ ] 高风险依赖有处理结论
+- [ ] 依赖审计命令可执行
+
+## 发布文件
+
+- [ ] `LICENSE` 存在且内容正确
+- [ ] `NOTICE` 是否需要已判断
+- [ ] README、CHANGELOG、SECURITY、CONTRIBUTING 等标准文件齐备
+- [ ] 包元数据中的 license/repository/homepage 字段正确
+
+## 发布排除
+
+- [ ] 不会发布父工程私有制品或内部规划文档
+- [ ] 不包含本机绝对路径
+- [ ] 不包含 token、密钥、凭据或内部 URL
+- [ ] 不包含未授权第三方素材
+
+## 安全与披露
+
+- [ ] 安全报告入口明确
+- [ ] 漏洞披露流程明确
+- [ ] 敏感信息扫描流程已定义
+- [ ] 阻塞级安全问题不会进入发布
+
+## 追溯性
+
+- [ ] 关联发布策略存在
+- [ ] 关联发布技能存在（如适用）
+- [ ] 合规结论可追溯到发布治理需求

package/adapters/codex/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/adapters/codex/templates/extended/governance/publish_skill/review-checklist.md

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

package/adapters/codex/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/adapters/codex/templates/extended/governance/release_policy/review-checklist.md

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