artifact-chain-assistant 0.8.0

package/adapters/codex/templates/extended/agent/agent_skill/starter.md

@@ -0,0 +1,133 @@
+---
+id: {SKILL_ID}
+title: {技能名称}
+status: draft
+related_features: []
+related_decisions: []
+---
+
+# {SKILL_ID}: {技能名称}
+
+<!-- 本模板是插件 starter 指导，项目本地模板可完全覆盖 -->
+<!-- 插件模板是入门指导，项目本地模板是权威 -->
+
+## 概述
+
+{描述这个 Agent 技能的用途、触发条件和主要能力}
+
+## 技能元信息
+
+- **名称**：{skill_name}
+- **描述**：{description}
+- **触发条件**：{触发条件}
+- **适用场景**：{适用场景}
+
+## 输入契约
+
+### 必需输入
+
+| 参数 | 类型 | 描述 |
+|------|------|------|
+| {param1} | {type} | {描述} |
+| {param2} | {type} | {描述} |
+
+### 可选输入
+
+| 参数 | 类型 | 默认值 | 描述 |
+|------|------|--------|------|
+| {param3} | {type} | {默认值} | {描述} |
+
+## 输出契约
+
+### 成功输出
+
+```json
+{
+  "success": true,
+  "data": {
+    "field1": "value",
+    "field2": "value"
+  }
+}
+```
+
+### 错误输出
+
+```json
+{
+  "success": false,
+  "error": {
+    "code": "ERROR_CODE",
+    "message": "错误描述"
+  }
+}
+```
+
+## 处理流程
+
+### 步骤 1：{步骤标题}
+
+**目的**：{步骤目的}
+
+**输入**：{输入}
+**处理**：{处理逻辑}
+**输出**：{输出}
+
+### 步骤 2：{步骤标题}
+
+{同上结构}
+
+## 工具依赖
+
+| 工具 | 用途 | 权限要求 |
+|------|------|---------|
+| {tool1} | {用途} | {权限} |
+| {tool2} | {用途} | {权限} |
+
+## 权限边界
+
+- **可访问资源**：{资源列表}
+- **禁止操作**：{禁止列表}
+- **数据访问范围**：{范围}
+
+## 错误处理
+
+| 错误码 | 描述 | 处理方式 |
+|--------|------|---------|
+| INVALID_INPUT | 输入无效 | 返回错误详情 |
+| PERMISSION_DENIED | 权限不足 | 提示权限要求 |
+| TOOL_ERROR | 工具调用失败 | 重试或降级 |
+
+## 示例
+
+### 示例 1：{场景描述}
+
+**输入**：
+```json
+{
+  "param1": "value1",
+  "param2": "value2"
+}
+```
+
+**输出**：
+```json
+{
+  "success": true,
+  "data": {
+    "result": "处理结果"
+  }
+}
+```
+
+## 关联制品
+
+- 功能特性：{related_features}
+- 决策：{related_decisions}
+- 设计文档：{related_designs}
+
+## 变更日志
+
+| 日期 | 变更 | 作者 |
+|------|------|------|
+| {YYYY-MM-DD} | 初始草稿 | {作者} |

package/adapters/codex/templates/extended/agent/hook_policy/review-checklist.md

@@ -0,0 +1,58 @@
+# Hook Policy 审查清单
+
+<!-- 本清单是插件通用基线，项目本地审查规则可覆盖 -->
+
+## 结构完整性
+
+- [ ] `id` 字段存在且符合项目 ID 模式（如 `HOOK-{nnn}`）
+- [ ] `title` 清晰描述策略范围
+- [ ] 适用范围已定义
+- [ ] 执行阶段已指定
+
+## 触发条件质量
+
+- [ ] 触发事件明确
+- [ ] 触发条件可验证
+- [ ] 排除条件已定义
+- [ ] 执行频率合理
+
+## 门禁规则质量
+
+- [ ] 规则描述清晰
+- [ ] 检查内容具体
+- [ ] 通过条件明确
+- [ ] 失败处理有定义
+
+## 绕过审批
+
+- [ ] 绕过条件明确
+- [ ] 审批流程完整
+- [ ] 审批记录可追溯
+- [ ] 绕过有效期已定义
+
+## 执行脚本
+
+- [ ] 脚本语法正确
+- [ ] 错误处理完整
+- [ ] 退出码语义明确
+- [ ] 脚本可测试
+
+## 审计与监控
+
+- [ ] 审计日志格式完整
+- [ ] 日志存储位置合理
+- [ ] 监控指标已配置
+- [ ] 告警阈值合理
+
+## 追溯性
+
+- [ ] 关联功能特性存在
+- [ ] 关联决策存在
+- [ ] 策略可追溯到安全需求
+
+## 安全性
+
+- [ ] 无硬编码凭证
+- [ ] 权限最小化
+- [ ] 敏感操作有审计
+- [ ] 绕过有审批记录

package/adapters/codex/templates/extended/agent/hook_policy/starter.md

@@ -0,0 +1,134 @@
+---
+id: {HOOK_ID}
+title: {Hook 策略标题}
+status: draft
+related_features: []
+related_decisions: []
+---
+
+# {HOOK_ID}: {Hook 策略标题}
+
+<!-- 本模板是插件 starter 指导，项目本地模板可完全覆盖 -->
+<!-- 插件模板是入门指导，项目本地模板是权威 -->
+
+## 概述
+
+{描述这个 Hook 策略的用途、适用范围和主要约束}
+
+## 策略信息
+
+- **策略名称**：{policy_name}
+- **适用范围**：{适用范围}
+- **优先级**：{优先级}
+- **执行阶段**：{pre-commit/post-commit/pre-push 等}
+
+## 触发条件
+
+### 触发事件
+
+| 事件 | 触发条件 | 执行频率 |
+|------|---------|---------|
+| {事件1} | {条件} | {频率} |
+| {事件2} | {条件} | {频率} |
+
+### 排除条件
+
+- {排除条件 1}
+- {排除条件 2}
+
+## 门禁规则
+
+### 规则 1：{规则名称}
+
+**描述**：{规则描述}
+
+**检查内容**：
+- {检查项 1}
+- {检查项 2}
+
+**通过条件**：{通过条件}
+
+**失败处理**：{失败处理方式}
+
+### 规则 2：{规则名称}
+
+{同上结构}
+
+## 绕过审批
+
+### 绕过条件
+
+{描述什么情况下可以绕过此策略}
+
+### 审批流程
+
+1. {审批步骤 1}
+2. {审批步骤 2}
+
+### 审批记录
+
+| 日期 | 申请人 | 审批人 | 原因 | 有效期 |
+|------|--------|--------|------|--------|
+| {日期} | {申请人} | {审批人} | {原因} | {有效期} |
+
+## 执行脚本
+
+```bash
+#!/bin/bash
+# Hook 执行脚本
+
+# 检查条件
+if [条件]; then
+  # 执行检查
+  {检查命令}
+
+  # 验证结果
+  if [验证条件]; then
+    echo "检查通过"
+    exit 0
+  else
+    echo "检查失败"
+    exit 1
+  fi
+fi
+```
+
+## 审计日志
+
+### 日志格式
+
+```json
+{
+  "timestamp": "ISO8601",
+  "hook": "{hook_name}",
+  "event": "{event}",
+  "result": "pass/fail",
+  "user": "{user}",
+  "details": {}
+}
+```
+
+### 日志存储
+
+- **位置**：{日志路径}
+- **保留期**：{保留期限}
+- **轮转策略**：{轮转策略}
+
+## 监控与告警
+
+| 指标 | 阈值 | 告警方式 |
+|------|------|---------|
+| 执行失败率 | < 5% | {告警方式} |
+| 执行时间 | < 10s | {告警方式} |
+
+## 关联制品
+
+- 功能特性：{related_features}
+- 决策：{related_decisions}
+- 设计文档：{related_designs}
+
+## 变更日志
+
+| 日期 | 变更 | 作者 |
+|------|------|------|
+| {YYYY-MM-DD} | 初始版本 | {作者} |

package/adapters/codex/templates/extended/agent/prompt_packet/review-checklist.md

@@ -0,0 +1,54 @@
+# Prompt Packet 审查清单
+
+<!-- 本清单是插件通用基线，项目本地审查规则可覆盖 -->
+
+## 结构完整性
+
+- [ ] `id` 字段存在且符合项目 ID 模式（如 `PP-{nnn}`）
+- [ ] `title` 清晰描述 Prompt Packet 用途
+- [ ] 适用场景已定义
+- [ ] 目标 Agent/工具已指定
+
+## 上下文组装质量
+
+- [ ] 必需上下文来源已列出
+- [ ] 上下文来源的类型和路径可解析
+- [ ] 可选上下文有明确增强效果说明
+- [ ] 无冗余或冲突的上下文来源
+
+## Prompt 模板质量
+
+- [ ] 系统提示覆盖角色和约束
+- [ ] 用户提示结构清晰
+- [ ] 占位符有明确来源和填充规则
+- [ ] Prompt 模板无歧义指令
+
+## 输出契约
+
+- [ ] 期望输出格式已定义
+- [ ] 质量标准可验证
+- [ ] 输出格式与下游消费方匹配
+
+## 组装流程
+
+- [ ] 组装步骤清晰
+- [ ] 每步有明确输入/输出
+- [ ] 组装流程可自动化或半自动化执行
+
+## 使用约束
+
+- [ ] Token 预算已估算
+- [ ] 更新频率合理
+- [ ] 适用范围和排除情况已定义
+
+## 追溯性
+
+- [ ] 关联功能特性存在
+- [ ] 关联决策存在
+- [ ] Prompt Packet 可追溯到用户需求
+
+## 可测试性
+
+- [ ] 示例输入/输出完整
+- [ ] 可在目标 Agent 环境中实际运行
+- [ ] 输出质量可回归验证

package/adapters/codex/templates/extended/agent/prompt_packet/starter.md

@@ -0,0 +1,106 @@
+---
+id: {PP_ID}
+title: {Prompt Packet 标题}
+status: draft
+related_features: []
+related_decisions: []
+---
+
+# {PP_ID}: {Prompt Packet 标题}
+
+<!-- 本模板是插件 starter 指导，项目本地模板可完全覆盖 -->
+<!-- 插件模板是入门指导，项目本地模板是权威 -->
+
+## 概述
+
+{描述这个 Prompt Packet 的用途：为哪个 AI 辅助任务组装上下文，解决什么问题}
+
+## 元信息
+
+- **名称**：{packet_name}
+- **描述**：{description}
+- **适用场景**：{使用场景}
+- **目标 Agent/工具**：{Claude Code / Codex / 其他}
+
+## 上下文组装
+
+### 必需上下文
+
+| 来源 | 类型 | 说明 |
+|------|------|------|
+| {source1} | {制品类型} | {为什么需要} |
+| {source2} | {制品类型} | {为什么需要} |
+
+### 可选上下文
+
+| 来源 | 类型 | 说明 |
+|------|------|------|
+| {source3} | {制品类型} | {增强效果} |
+
+## Prompt 模板
+
+### 系统提示
+
+```
+{系统提示内容}
+```
+
+### 用户提示
+
+```
+{用户提示内容}
+```
+
+### 上下文注入点
+
+| 占位符 | 来源 | 填充规则 |
+|--------|------|---------|
+| `{placeholder1}` | {source} | {规则} |
+| `{placeholder2}` | {source} | {规则} |
+
+## 输出契约
+
+### 期望输出格式
+
+```json
+{
+  "result": "期望输出结构"
+}
+```
+
+### 质量标准
+
+- {标准1}
+- {标准2}
+
+## 组装流程
+
+### 步骤 1：{步骤标题}
+
+**目的**：{步骤目的}
+
+**输入**：{输入}
+**处理**：{处理逻辑}
+**输出**：{输出}
+
+### 步骤 2：{步骤标题}
+
+{同上结构}
+
+## 使用约束
+
+- **Token 预算**：{预期 token 消耗范围}
+- **更新频率**：{多久需要重新组装}
+- **适用范围**：{不适用的情况}
+
+## 关联制品
+
+- 功能特性：{related_features}
+- 决策：{related_decisions}
+- Agent 技能：{关联的 agent_skill 制品}
+
+## 变更日志
+
+| 日期 | 变更 | 作者 |
+|------|------|------|
+| {YYYY-MM-DD} | 初始草稿 | {作者} |

package/adapters/codex/templates/extended/contracts/api_contract/review-checklist.md

@@ -0,0 +1,43 @@
+# API Contract 审查清单
+
+<!-- 本清单是插件通用基线，项目本地审查规则可覆盖 -->
+
+## 结构完整性
+
+- [ ] `id` 字段存在且符合项目 ID 模式（如 `API-{nnn}` 或 `{service}-API-{version}`）
+- [ ] `title` 清晰描述 API 范围
+- [ ] `version` 字段存在且符合语义化版本
+- [ ] `status` 字段存在且为有效值
+
+## 接口质量
+
+- [ ] 每个端点有清晰描述
+- [ ] 请求参数类型和必填性明确
+- [ ] 响应格式完整且示例正确
+- [ ] 错误码覆盖常见异常场景
+
+## 数据模型
+
+- [ ] 数据模型定义完整
+- [ ] 字段类型和约束明确
+- [ ] 枚举值有文档说明
+- [ ] 嵌套关系清晰
+
+## 安全性
+
+- [ ] 认证方式已说明
+- [ ] 敏感字段已标记
+- [ ] 权限要求已记录
+- [ ] 速率限制已说明（如适用）
+
+## 追溯性
+
+- [ ] 关联功能特性存在
+- [ ] API 可追溯到业务需求
+- [ ] 版本变更可追溯
+
+## 实现一致性
+
+- [ ] 与实现代码一致
+- [ ] 文档与实际行为匹配
+- [ ] 测试覆盖所有端点

package/adapters/codex/templates/extended/contracts/api_contract/starter.md

@@ -0,0 +1,92 @@
+---
+id: {API_ID}
+title: {API 名称}
+status: draft
+version: {v1}
+base_url: {基础 URL}
+related_features: []
+---
+
+# {API_ID}: {API 名称}
+
+<!-- 本模板是插件 starter 指导，项目本地模板可完全覆盖 -->
+<!-- 插件模板是入门指导，项目本地模板是权威 -->
+
+## 概述
+
+{描述这个 API 的用途、范围和主要能力}
+
+## 基础信息
+
+- **版本**：{version}
+- **Base URL**：{base_url}
+- **协议**：REST / GraphQL / gRPC
+- **认证方式**：{认证方式}
+
+## 端点列表
+
+### {METHOD} {路径}
+
+**描述**：{端点描述}
+
+**请求参数**：
+
+| 参数 | 类型 | 必填 | 描述 |
+|------|------|------|------|
+| {param} | {type} | {yes/no} | {描述} |
+
+**请求体**（如适用）：
+
+```json
+{
+  "field1": "type",
+  "field2": "type"
+}
+```
+
+**响应**：
+
+```json
+{
+  "success": true,
+  "data": {
+    "field1": "value"
+  }
+}
+```
+
+**错误码**：
+
+| 状态码 | 错误码 | 描述 |
+|--------|--------|------|
+| 400 | INVALID_PARAM | 参数无效 |
+| 401 | UNAUTHORIZED | 未认证 |
+| 404 | NOT_FOUND | 资源不存在 |
+
+## 数据模型
+
+### {Model Name}
+
+```json
+{
+  "id": "string",
+  "name": "string",
+  "created_at": "datetime"
+}
+```
+
+## 版本兼容性
+
+{描述版本兼容策略和破坏性变更规则}
+
+## 关联制品
+
+- 功能特性：{related_features}
+- 设计文档：{related_designs}
+- 决策：{related_decisions}
+
+## 变更日志
+
+| 日期 | 版本 | 变更 | 作者 |
+|------|------|------|------|
+| {YYYY-MM-DD} | v1 | 初始版本 | {作者} |

package/adapters/codex/templates/extended/contracts/batch_job_contract/review-checklist.md

@@ -0,0 +1,82 @@
+# Batch Job Contract 审查清单
+
+<!-- 本清单是插件通用基线，项目本地审查规则可覆盖 -->
+
+## 结构完整性
+
+- [ ] `id` 字段存在且符合项目 ID 模式（如 `BATCH-{nnn}`）
+- [ ] `title` 清晰描述批处理作业范围
+- [ ] `version` 字段存在且符合语义化版本
+- [ ] `status` 字段存在且为有效值
+- [ ] `schedule` 字段存在且为有效 cron 表达式
+
+## 输入定义
+
+- [ ] 所有数据源已列出
+- [ ] 数据源类型明确（数据库 / 文件 / API / 消息队列）
+- [ ] 输入参数完整且类型明确
+- [ ] 输入格式示例正确
+
+## 输出定义
+
+- [ ] 所有输出目标已列出
+- [ ] 输出目标类型明确
+- [ ] 输出参数完整且类型明确
+- [ ] 输出格式示例正确
+
+## 处理逻辑
+
+- [ ] 主流程步骤清晰
+- [ ] 分片策略已定义（方式、大小、并行度）
+- [ ] 过滤条件已列出
+- [ ] 边界情况处理已说明
+
+## 幂等性
+
+- [ ] 幂等策略已定义
+- [ ] 唯一键组成字段明确
+- [ ] 冲突处理策略已说明
+- [ ] 重复执行行为已定义
+
+## 错误处理
+
+- [ ] 错误分类已定义（数据 / 系统 / 业务）
+- [ ] 每类错误的处理策略已说明
+- [ ] 错误记录方式已定义
+- [ ] 单条失败处理策略已说明
+- [ ] 批量失败处理策略已说明
+- [ ] 作业失败处理策略已说明
+
+## 监控与告警
+
+- [ ] 关键监控指标已定义（处理量、成功数、失败数、时长）
+- [ ] 告警规则已定义
+- [ ] 告警级别和通知方式已说明
+- [ ] 监控阈值合理
+
+## 性能要求
+
+- [ ] 预期数据量已评估
+- [ ] 处理时间要求已定义
+- [ ] 资源限制已说明
+
+## 回滚策略
+
+- [ ] 回滚条件已定义
+- [ ] 回滚方式已说明（手动 / 自动）
+- [ ] 回滚步骤清晰
+- [ ] 数据一致性保证已说明
+
+## 追溯性
+
+- [ ] 关联功能特性存在
+- [ ] 批处理作业可追溯到业务需求
+- [ ] 版本变更可追溯
+- [ ] 关联设计文档存在
+
+## 实现一致性
+
+- [ ] 与实现代码一致
+- [ ] 文档与实际行为匹配
+- [ ] 测试覆盖核心场景
+- [ ] 性能满足要求