关于 checklist
面向 Claude Code 工作流的技能,可将对话中最近的计划、代码审查或任务步骤整理为 Markdown 检查清单并保存到项目。它会依据内容类型决定勾选粒度,并在目标文件已存在时先征求确认。
主要功能
- 01识别对话中最近的结构化内容
- 02按内容类型确定清单粒度
- 03保留原文并添加勾选框
- 04检查目标文件并询问是否覆盖
- 05创建计划目录并保存 Markdown 文件
适用场景
- 01将已审阅的计划转为可跟踪清单
- 02整理大型步骤的代码审查任务
- 03为项目任务列表生成 Markdown 文件
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ unlearndev/ skills --skill checklist安装后在 Claude Code 中输入/checklist确认已加载。
详细介绍
检查清单
你的任务
将本次对话中最近的结构化内容(计划、代码审查、任务列表、实现步骤等)转换为 Markdown 检查清单文件并保存到项目中。
说明
1. 识别内容
查看当前对话上下文,找到最近的计划、代码审查、实现步骤或其他结构化内容。这就是你要转换的内容。
2. 生成名称
根据内容主题生成一个简短、描述性且采用 kebab-case 格式的名称(例如:auth-refactor、api-migration、payment-integration)。文件将保存为 .claude/plans/<name>-checklist.md。
3. 检查是否存在同名文件
写入前,检查 .claude/plans/<name>-checklist.md 是否已存在。如果存在,询问用户是要覆盖、选择其他名称还是取消。未得到用户答复前,请勿继续。
4. 确定合适的检查清单粒度
转换前,评估复选框应采用什么粒度:
- 如果内容是由你在计划模式下生成的计划: 保持计划文本原样不变。不要改写、概述、转述或重新组织内容。只在主要实现章节/步骤前添加
- [ ]标记,不要为每个细小子步骤添加标记。用户已审阅并批准此计划;你的工作只是让它可跟踪。 - 如果内容是已有明确大型步骤/章节的计划: 在这些大型步骤的级别添加
- [ ]标记。不要再进一步拆分为微小复选项。 - 如果内容是没有明确章节划分的通用任务列表或非结构化内容: 在继续前询问用户希望如何拆分。不要自行猜测或确定粒度。
5. 转换为检查清单格式
按照以下规则将内容转换为检查清单文件:
- 保留原文不变:保留所有标题、章节、分组、嵌套结构、顺序和措辞。不要改写、概述或转述任何内容。
- 仅在第 4 步确定的顶层可执行章节前添加
- [ ]复选框标记 - 非可执行文本(说明、背景、理由、章节内的子项详情)保持原样,不添加复选框。
- 保持标题层级(##、### 等)与原文完全一致。
- 如果章节中已有项目符号或编号列表,保持原样(它们是带复选框章节的详细内容,不是单独的检查清单项)。
- 仅当原文有明确的多层结构(不同阶段/子阶段)时,才使用嵌套复选框(例如:
- [ ])。
6. 添加跟踪标题
在文件最顶部、其他内容之前添加以下确切内容:
7. 确保目录存在
如果 .claude/plans/ 目录不存在,请创建该目录。
8. 写入文件
将检查清单保存到 .claude/plans/<name>-checklist.md。
9. 确认
告知用户文件路径,并简要说明其中包含的内容。提醒用户完成项目后会将其勾选。
评论
支持 Markdown