snag-list-defect-handover-signoff

mcp-checklist

已收录于 官方 MCP Registry（io.github.theluckystrike/checklist）。 只需创建一次，即可反复运行的清单，以及每次运行由某人签署的日期记录。清单是一个命名步骤列表，可选择按分区分组，每个步骤为必需或可选。运行是针对某项工作执行一次清单：每个步骤都标记为通过、失败或不适用，并记录标记者和日期，以及说明发现情况的备注。随后，run_sign_off 会为其添加姓名和日期，并将其锁定。

决定其他一切的一条规则

如果有人之后编辑清单， 添加或删除步骤，所有已经开始的运行仍会保留其开始时的步骤列表， 并在运行中记录复制该列表时所用的版本。

这不是为了方便缓存。有人勾选并签署的清单，必须与他们实际看到的清单一致。如果运行实时读取清单中的步骤，就可能出现一份已签署的交接证明列出 11 项检查，而签署者看到的却是 10 项，且记录中没有任何字段显示发生过这种情况。这也意味着删除清单后，其运行记录仍然可读且完整；一年后有人询问检查过什么时，这正是你所需要的。

由此还可得出两条较小的规则：

• 不存储任何派生数据。 通过、失败和未完成的数量、百分比，以及运行是否可以签署，都会在每次调用时根据运行自身的步骤计算。存储的“已完成”标记，只反映某人上次查看时的情况；这里的 complete 是一种实时状态：最后一个步骤得到答复时它会出现，而当某个步骤重新设为待处理时它又会消失。
• 不适用不等于通过。 na 计为已回答，绝不计为通过。检查过后判定不适用，与检查通过是两种不同的事实；将两者合并，就会让清单在一半步骤都不适用的工作中报告满分。

哪些情况会阻止签署

必需步骤未作答、必需步骤失败、可选步骤未作答，或运行不包含任何步骤。force: true 会强制签署，例外情况仍会保留在记录中，并在报告的“Signed with exceptions”下列出。它们不会丢失，也不会被隐去。

安装

一键安装（.mcpb）：从最新版本下载 checklist.mcpb，并在 Claude Desktop 中双击：https://github.com/theluckystrike/mcp-servers/releases/latest

@theluckystrike/mcp-checklist 的 npm 发布尚未完成，因此下方的 npx 命令目前会返回 404。此期间请从源代码构建；参见 llms-install.md。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "checklist": {
      "command": "npx",
      "args": ["-y", "@theluckystrike/mcp-checklist"]
    }
  }
}

Claude Code

claude mcp add checklist -- npx -y @theluckystrike/mcp-checklist

Cursor

~/.cursor/mcp.json（全局）或 .cursor/mcp.json（项目），配置项与 Claude Desktop 相同。

工具

工具	功能
checklist_create	创建可重复使用的清单：名称、类别和描述
checklist_item_add	添加步骤：文本、分节标题，以及是否为必需项
checklist_item_remove	移除步骤并提升版本号。已开始的运行会保留该步骤
checklist_show	按分节分组显示一份清单，并可按需提供空白可打印副本
checklist_list	列出所有清单及其版本、步骤数和由其创建的运行数
checklist_delete	删除清单。其运行仍可查看，因为每次运行都包含自己的副本
run_start	针对一项工作启动一次注明日期的运行。此时会将步骤复制到运行中
run_check	将某一步标记为通过、失败或不适用，并记录执行人、时间和发现的问题
run_show	查看运行：每个步骤及其答案、计数、失败项，以及阻止签核的事项
run_list	按时间从新到旧列出运行，可按清单、状态、参考信息筛选，或仅显示有失败项的运行
run_sign_off	使用姓名和日期签核，之后该运行将被冻结
run_status	重新打开已完成的运行，或在工作未发生时将其放弃
run_report	以文本形式查看运行报告，适用于所有层级。Pro 还会将报告写入 out_path，保存为 .txt 文件
run_delete	删除一次运行。已签核的运行无法删除
license_status	查看此安装所属的层级以及密钥来源
license_activate	为此服务保存 Pro 密钥

此外还有一个资源 checklist://contract，其中包含快照规则、项目状态、运行状态机、阻止签核的事项，以及此服务的写入位置；还有一个提示词 run_the_checklist，会按顺序引导完成整项工作。

免费版与 Pro 版

	免费版	Pro 版
可保留的清单数	3	无限
清单运行次数	无限	无限
每份清单的步骤数	最多 500	最多 500
run_show、run_list 和计数	是	是
以文本形式查看运行报告	是	是
使用 out_path 将报告写入文件	否	是

限制依据是你保留的不同清单数量，而不是检查的工作数量。一家有交付前检查表、交接表和缺陷清单的企业，全年都可以使用免费版。运行次数从不受限，因为限制清单的运行次数，就等于限制清单唯一的用途。删除清单即可腾出一个名额。

获取 Pro：https://mcp.zovo.one/buy/checklist（一次性付费），或以一个价格使用所有服务：https://mcp.zovo.one/buy/bundle

隐私

所有数据都保存在本地，路径为 ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/checklist/。此服务不会进行任何网络调用，无需 API 密钥，也无需账户。它只会读取一份非自有文件，即共享业务资料中的名称和地址，用于打印报告的顶部信息；并且绝不会写入该文件。

由 theluckystrike 构建。支持邮箱：[email protected]

将这些文档用作 MCP 服务

任何 MCP 客户端（Claude、Cursor、Windsurf、VS Code）都可以通过 GitMCP 直接读取此代码库的文档，无需安装：

• 文档 MCP URL：https://gitmcp.io/theluckystrike/mcp-checklist