artifact-chain-assistant 0.8.0

package/templates/extended/contracts/report_contract/starter.md

@@ -0,0 +1,97 @@
+---
+id: {RPT_ID}
+title: {报告名称}
+status: draft
+version: {v1}
+output_format: {输出格式}
+related_features: []
+---
+
+# {RPT_ID}: {报告名称}
+
+<!-- 本模板是插件 starter 指导，项目本地模板可完全覆盖 -->
+<!-- 插件模板是入门指导，项目本地模板是权威 -->
+
+## 概述
+
+{描述这个报告的用途、业务场景和主要能力}
+
+## 基础信息
+
+- **版本**：{version}
+- **输出格式**：PDF / Excel / CSV / JSON / HTML
+- **生成频率**：每日 / 每周 / 每月 / 按需
+- **数据时效性**：实时 / T+1 / 截止到指定时间点
+- **目标受众**：{报告的使用者，如业务分析师、管理层、运维团队}
+
+## 报告结构
+
+### 数据源
+
+| 数据源 | 类型 | 刷新频率 | 说明 |
+|--------|------|---------|------|
+| {数据源名称} | 数据库 / API / 文件 | {频率} | {数据源描述} |
+
+### 字段定义
+
+| 字段名 | 类型 | 聚合逻辑 | 说明 |
+|--------|------|---------|------|
+| {field_name} | {type} | SUM / AVG / COUNT / MAX / MIN / NONE | {字段含义} |
+
+### 时间窗口
+
+- **报告周期**：{报告覆盖的时间范围，如"过去 30 天"}
+- **时间粒度**：小时 / 天 / 周 / 月
+- **时区**：{时区，如 UTC / Asia/Shanghai}
+- **截止规则**：{数据截止时间点的定义，如"每日凌晨 2:00 截止"}
+
+## 报告示例
+
+### 示例输出
+
+```
+{报告输出的示例片段}
+```
+
+## 聚合逻辑
+
+### 计算规则
+
+{描述关键指标的计算方法，如"订单金额 = SUM(订单明细.单价 * 数量)"}
+
+### 过滤条件
+
+| 条件 | 字段 | 运算符 | 值 | 说明 |
+|------|------|--------|-----|------|
+| {条件名称} | {field} | = / != / > / < / IN / LIKE | {value} | {条件描述} |
+
+### 排序规则
+
+| 排序字段 | 方向 | 说明 |
+|---------|------|------|
+| {field} | ASC / DESC | {排序逻辑} |
+
+## 权限与安全
+
+- **数据权限**：{报告访问的数据范围控制}
+- **用户权限**：{哪些角色可以访问}
+- **敏感字段**：{是否包含敏感数据，如何脱敏}
+
+## 性能要求
+
+- **生成时间**：{报告生成的最大允许时间}
+- **数据量级**：{预期数据行数}
+- **并发支持**：{是否支持多人同时生成}
+
+## 关联制品
+
+- 功能特性：{related_features}
+- 数据契约：{related_data_contracts}
+- 设计文档：{related_designs}
+- 决策：{related_decisions}
+
+## 变更日志
+
+| 日期 | 版本 | 变更 | 作者 |
+|------|------|------|------|
+| {YYYY-MM-DD} | v1 | 初始版本 | {作者} |

package/templates/extended/contracts/ui_contract/review-checklist.md

@@ -0,0 +1,70 @@
+# UI Contract 审查清单
+
+<!-- 本清单是插件通用基线，项目本地审查规则可覆盖 -->
+
+## 结构完整性
+
+- [ ] `id` 字段存在且符合项目 ID 模式（如 `UI-{nnn}`）
+- [ ] `title` 清晰描述 UI 流程范围
+- [ ] `version` 字段存在且符合语义化版本
+- [ ] `status` 字段存在且为有效值
+
+## 用户流程
+
+- [ ] 主流程步骤清晰完整
+- [ ] 分支流程有明确条件说明
+- [ ] 流程起始和结束状态明确
+- [ ] 用户操作和系统响应对应关系清晰
+
+## 状态管理
+
+- [ ] 所有状态已列出
+- [ ] 状态转换条件明确
+- [ ] 无死循环或不可达状态
+- [ ] 错误状态有恢复路径
+
+## 交互设计
+
+- [ ] 表单元素类型和验证规则完整
+- [ ] 按钮行为和禁用条件明确
+- [ ] 快捷键定义清晰（如适用）
+- [ ] 加载状态有明确反馈
+
+## 错误处理
+
+- [ ] 错误类型覆盖完整（网络、验证、权限、服务器）
+- [ ] 错误提示用户友好
+- [ ] 错误恢复方式明确
+- [ ] 错误展示方式符合设计规范
+
+## 可访问性
+
+- [ ] ARIA 标签完整
+- [ ] 键盘导航支持
+- [ ] 颜色对比度符合标准
+- [ ] 屏幕阅读器兼容
+
+## 响应式设计
+
+- [ ] 断点定义清晰
+- [ ] 各断点布局调整明确
+- [ ] 元素变化有说明
+- [ ] 移动端交互适配
+
+## 性能要求
+
+- [ ] 性能指标有明确目标
+- [ ] 测量方式有说明
+- [ ] 关键路径有优化策略
+
+## 追溯性
+
+- [ ] 关联功能特性存在
+- [ ] UI 流程可追溯到业务需求
+- [ ] 与 API 契约关联清晰
+
+## 实现一致性
+
+- [ ] 与实际实现代码一致
+- [ ] 文档与实际行为匹配
+- [ ] 设计稿与文档描述一致

package/templates/extended/contracts/ui_contract/starter.md

@@ -0,0 +1,150 @@
+---
+id: {UI_ID}
+title: {UI 流程名称}
+status: draft
+version: {v1}
+related_features: []
+---
+
+# {UI_ID}: {UI 流程名称}
+
+<!-- 本模板是插件 starter 指导，项目本地模板可完全覆盖 -->
+<!-- 插件模板是入门指导，项目本地模板是权威 -->
+
+## 概述
+
+{描述这个 UI 流程的用途、目标用户和核心交互}
+
+## 基础信息
+
+- **版本**：{version}
+- **适用平台**：Web / Desktop / Mobile
+- **页面/组件**：{页面或组件名称}
+- **入口**：{用户如何进入此流程}
+
+## 用户流程
+
+### 主流程
+
+```
+用户操作 → 系统响应 → 下一步
+    ↓
+[步骤 1] {操作描述}
+    ↓
+[步骤 2] {系统响应}
+    ↓
+[步骤 3] {后续操作}
+    ↓
+[完成] {最终状态}
+```
+
+### 分支流程
+
+| 条件 | 分支路径 | 说明 |
+|------|---------|------|
+| {条件描述} | {分支路径} | {说明} |
+
+## 状态转换
+
+### 状态列表
+
+| 状态 | 描述 | 可转换到 |
+|------|------|---------|
+| initial | 初始状态 | loading, ready |
+| loading | 加载中 | ready, error |
+| ready | 就绪状态 | loading, completed |
+| error | 错误状态 | loading, ready |
+| completed | 完成状态 | - |
+
+### 状态转换图
+
+```
+[initial] → [loading] → [ready] → [completed]
+                ↓            ↓
+            [error] ←--------
+```
+
+## 交互元素
+
+### 表单元素
+
+| 元素 | 类型 | 必填 | 验证规则 | 错误提示 |
+|------|------|------|---------|---------|
+| {字段名} | {input/select/checkbox} | {yes/no} | {验证规则} | {错误提示} |
+
+### 按钮和操作
+
+| 按钮 | 位置 | 行为 | 禁用条件 |
+|------|------|------|---------|
+| {按钮名} | {位置} | {点击后行为} | {何时禁用} |
+
+### 快捷键
+
+| 快捷键 | 功能 | 适用场景 |
+|--------|------|---------|
+| {快捷键} | {功能} | {场景} |
+
+## 错误处理
+
+### 错误类型
+
+| 错误类型 | 触发条件 | 用户提示 | 恢复方式 |
+|---------|---------|---------|---------|
+| 网络错误 | 网络请求失败 | "网络连接失败，请重试" | 重试按钮 |
+| 验证错误 | 输入不符合规则 | {字段级错误提示} | 修正输入 |
+| 权限错误 | 无操作权限 | "无权限执行此操作" | 联系管理员 |
+| 服务器错误 | 后端返回错误 | "服务暂时不可用" | 重试或稍后再试 |
+
+### 错误展示
+
+- **字段级错误**：在对应字段下方显示红色提示
+- **页面级错误**：顶部 Toast 或 Alert 组件
+- **阻断级错误**：模态对话框，需用户确认
+
+## 可访问性
+
+### ARIA 标签
+
+| 元素 | aria-label | aria-describedby |
+|------|-----------|------------------|
+| {元素} | {标签} | {描述元素 ID} |
+
+### 键盘导航
+
+- Tab 顺序：{说明 Tab 键导航顺序}
+- 焦点管理：{说明焦点如何移动}
+- 屏幕阅读器：{说明屏幕阅读器如何播报}
+
+### 视觉设计
+
+- 颜色对比度：符合 WCAG 2.1 AA 标准
+- 字体大小：最小 14px
+- 点击区域：最小 44x44px
+
+## 响应式设计
+
+| 断点 | 布局调整 | 元素变化 |
+|------|---------|---------|
+| Desktop (>1200px) | {布局描述} | {元素变化} |
+| Tablet (768-1200px) | {布局描述} | {元素变化} |
+| Mobile (<768px) | {布局描述} | {元素变化} |
+
+## 性能要求
+
+| 指标 | 目标值 | 测量方式 |
+|------|-------|---------|
+| 首屏加载 | < {X} 秒 | Lighthouse |
+| 交互响应 | < {X} 毫秒 | 用户感知 |
+| 动画流畅 | 60fps | DevTools |
+
+## 关联制品
+
+- 功能特性：{related_features}
+- 设计文档：{related_designs}
+- API 契约：{related_api_contracts}
+
+## 变更日志
+
+| 日期 | 版本 | 变更 | 作者 |
+|------|------|------|------|
+| {YYYY-MM-DD} | v1 | 初始版本 | {作者} |

package/templates/extended/domain/database_migration/review-checklist.md

@@ -0,0 +1,51 @@
+# Database Migration 审查清单
+
+<!-- 本清单是插件通用基线，项目本地审查规则可覆盖 -->
+
+## 结构完整性
+
+- [ ] `id` 字段存在且符合项目 ID 模式（如 `MIG-{nnn}` 或时间戳）
+- [ ] `title` 清晰描述迁移内容
+- [ ] `database` 已指定
+- [ ] 迁移类型已标注（DDL / DML / 混合）
+
+## SQL 质量
+
+- [ ] 正向迁移 SQL 语法正确
+- [ ] 回滚 SQL 语法正确且与正向迁移对称
+- [ ] SQL 已在测试环境验证
+- [ ] 无硬编码环境变量或凭证
+
+## 兼容性与安全
+
+- [ ] 向前/向后兼容性已分析
+- [ ] 应用停机需求已明确
+- [ ] NOT NULL 约束处理策略已说明
+- [ ] 默认值策略合理
+
+## 回滚方案
+
+- [ ] 回滚 SQL 完整可执行
+- [ ] 回滚触发条件明确
+- [ ] 回滚窗口已定义
+- [ ] 回滚数据丢失风险已评估
+
+## 性能影响
+
+- [ ] 锁策略已评估
+- [ ] 大表变更策略已说明（分批 / 在线 DDL）
+- [ ] 预估执行时间合理
+- [ ] 迁移期间监控方案已定义
+
+## 验证方案
+
+- [ ] 迁移前检查项完整
+- [ ] 迁移后验证步骤可执行
+- [ ] 数据完整性校验方案存在
+- [ ] 回归测试覆盖关键场景
+
+## 追溯性
+
+- [ ] 关联数据契约存在
+- [ ] 关联功能特性存在
+- [ ] 迁移可追溯到 schema 变更原因

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

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

package/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/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
+- [ ] 不包含未授权第三方素材
+
+## 安全与披露
+
+- [ ] 安全报告入口明确
+- [ ] 漏洞披露流程明确
+- [ ] 敏感信息扫描流程已定义
+- [ ] 阻塞级安全问题不会进入发布
+
+## 追溯性
+
+- [ ] 关联发布策略存在
+- [ ] 关联发布技能存在（如适用）
+- [ ] 合规结论可追溯到发布治理需求