checklist

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

清单 (Checklist) 📋

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

---

🎯 何时使用

在以下情况下使用此技能：

• 用户要求创建任务清单
• 用户需要跟踪流程中的多个步骤
• 复杂的多步骤操作需要验证
• 需要质量保证或审查流程
• 入职或设置程序
• 部署前的“飞行前检查”

---

📋 支持的任务类别

1. 开发与 DevOps

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

2. 安全与合规性

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

3. 运营

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

4. 项目管理

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

5. 健康与安全

清单	描述
健康检查	系统健康验证
应急响应	紧急程序
安全检查	安全合规

---

⚡ 快速命令

# 从模板创建清单
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)

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

---

🎯 最佳实践

1. 从模板开始

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

2. 保持具体

每个清单项目应当是：

• 可操作的 —— 明确要采取的行动
• 可验证的 —— 可以确认完成
• 原子的 —— 单一任务，而非复合任务

3. 跟踪进度

定期更新清单状态：

• 查看剩余项
• 识别阻塞项
• 记录跳过的项目

4. 完成后回顾

完成清单后：

• 查看跳过的项目及其原因
• 为下一次改进提供建议
• 导出文档

---

⚠️ 重要提示

何时使用清单

✅ 建议使用清单：

• 多步骤程序
• 复杂的部署
• 安全审查
• 入职
• 质量保证 (QA)

❌ 不要过度使用：

• 简单的 1-2 步任务
• 无固定步骤的创意工作
• 临时性的小问题

与其他技能的整合

清单适用于：

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

---

🦞 总结

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