Checklist 1.0.0

---
name: checklist
version: 1.0.0
description: "AI 代理的任务清单管理器。用于创建、管理和跟踪复杂任务的清单。有助于确保任务执行期间不会遗漏任何步骤。"
---

# 清单 (Checklist) 📋

**AI 代理的任务清单管理器。创建、管理和跟踪复杂任务的清单。**

---

## 🎯 何时使用

在以下情况下使用此技能：
- 用户要求创建任务清单
- 用户需要跟踪流程中的多个步骤
- 复杂的多步骤操作需要验证
- 需要质量保证或审查流程
- 入职或设置程序
- 部署前的“飞行前检查”

---

## 📋 支持的任务类别

### 1. 开发与 DevOps
| 清单 | 描述 |
|------------|-------------|
| 代码审查 | 提交前审核清单 |
| 部署 | 部署前验证 |
| 错误修复 | Bug 修复验证步骤 |
| API 变更 | API 修改清单 |
| 数据库迁移 | 数据库更改安全检查表 |

### 2. 安全与合规性
| 清单 | 描述 |
|------------|-------------|
| 安全审查 | 发布前的安全检查 |
| 渗透测试 | 安全测试清单 |
| 合规性 | 监管合规清单 |
| 审计 | 审计准备清单 |

### 3. 运营
| 清单 | 描述 |
|------------|-------------|
| 入职 | 新团队成员设置 |
| 事件响应 | 事件处理步骤 |
| 备份 | 备份验证清单 |
| 监控 | 系统健康检查表 |

### 4. 项目管理
| 清单 | 描述 |
|------------|-------------|
| 冲刺计划 | 冲刺 (Sprint) 计划准备 |
| 回顾 | 回顾动作项目 |
| 发布 | 发布准备 |
| 功能标志 (Feature Flag) | 功能开关清单 |

### 5. 健康与安全
| 清单 | 描述 |
|------------|-------------|
| 健康检查 | 系统健康验证 |
| 应急响应 | 紧急程序 |
| 安全检查 | 安全合规 |

---

## ⚡ 快速命令

```bash
# 从模板创建清单
checklist create <template-name>

# 列出可用模板
checklist templates

# 显示当前清单
checklist show

# 将项目标记为已完成
checklist done <item-number>

# 将项目标记为已跳过
checklist skip <item-number> --reason "..."

# 添加自定义项目
checklist add "<item-description>"

# 移除项目
checklist remove <item-number>

# 重置清单
checklist reset

# 导出清单
checklist export
```

---

## 📝 使用示例

### 示例 1：创建预部署清单

```
用户：我需要将应用部署到生产环境

AI：[执行：checklist create deploy]

✅ 已创建 **生产部署 (Production Deployment)** 清单：

1. ☐ 本地运行所有测试
2. ☐ 在 git diff 中审查代码更改
3. ☐ 检查环境变量是否已设置
4. ☐ 验证数据库迁移是否安全
5. ☐ 启用维护模式（如需要）
6. ☐ 先部署到分级环境 (Staging)
7. ☐ 在分级环境运行冒烟测试
8. ☐ 备份数据库
9. ☐ 部署到生产环境
10. ☐ 验证健康检查端点
11. ☐ 检查日志中的错误
12. ☐ 通知利益相关者
13. ☐ 禁用维护模式

进度：0/13 (0%)
```

### 示例 2：跟踪进度

```
用户：我已经完成了第 3 步和第 4 步

AI：[执行：checklist done 3 && checklist done 4]

✅ 已更新进度：

1. ✅ 本地运行所有测试
2. ✅ 在 git diff 中审查代码更改
3. ✅ 检查环境变量是否已设置
4. ✅ 验证数据库迁移是否安全
5. ☐ 启用维护模式（如需要）
6. ☐ 先部署到分级环境 (Staging)
...

进度：4/13 (31%)
```

### 示例 3：自定义清单

```
用户：为代码审查创建一个清单

AI：[执行：checklist add "检查 SQL 注入漏洞"]
[执行：checklist add "验证是否强制身份认证"]
[执行：checklist add "审查错误处理"]

✅ 已创建自定义清单：

1. ☐ 检查 SQL 注入漏洞
2. ☐ 验证是否强制身份认证
3. ☐ 审查错误处理
4. ☐ 检查硬编码的凭据
5. ☐ 验证输入验证
```

---

## 🔧 实施

### 清单存储

清单存储在 `~/.checklist/` 中：
- `~/.checklist/templates/` - 内置模板
- `~/.checklist/active/` - 当前活跃清单
- `~/.checklist/history/` - 已完成的历史清单

### 模板格式 (JSON)

```json
{
  "name": "部署清单",
  "description": "部署前验证步骤",
  "items": [
    {
      "id": 1,
      "text": "本地运行所有测试",
      "required": true
    },
    {
      "id": 2,
      "text": "审查代码更改",
      "required": true
    }
  ]
}
```

---

## 🎯 最佳实践

### 1. 从模板开始
使用现有的内置模板 —— 它们针对常见场景进行了优化。

### 2. 保持具体
每个清单项目应当是：
- **可操作的** —— 明确要采取的行动
- **可验证的** —— 可以确认完成
- **原子的** —— 单一任务，而非复合任务

### 3. 跟踪进度
定期更新清单状态：
- 查看剩余项
- 识别阻塞项
- 记录跳过的项目

### 4. 完成后回顾
完成清单后：
- 查看跳过的项目及其原因
- 为下一次改进提供建议
- 导出文档

---

## ⚠️ 重要提示

### 何时使用清单

✅ **建议使用清单：**
- 多步骤程序
- 复杂的部署
- 安全审查
- 入职
- 质量保证 (QA)

❌ **不要过度使用：**
- 简单的 1-2 步任务
- 无固定步骤的创意工作
- 临时性的小问题

### 与其他技能的整合

清单适用于：
- **任务控制** —— 将清单项目转换为正式任务
- **GitHub** —— 提交前/部署清单
- **健康检查** —— 安全检查表

---

## 🦞 总结

**一句话：当用户需要跟踪多步骤任务时 → 创建清单 → 跟踪进度 → 确保没有遗漏。**