ln-015-hex-line-uninstaller

路径： 文件路径相对于 skills 仓库根目录。找到此 SKILL.md 所在目录，并向上一级到达仓库根目录。

Hex-Line 卸载程序

类型： L3 工作器
类别： 0XX 共享

移除 Claude 端的 hex-line 集成界面。此工作器可独立运行，也支持受管的 ln-010 系列传输。

必须阅读： 加载 references/coordinator_summary_contract.md、references/environment_worker_runtime_contract.md 和 references/worker_runtime_contract.md

此工作器直接从配置文件和 CLI 状态中清理 Claude 端状态。缺少 MCP 连通性不会阻止操作；应尽可能继续执行本地清理和验证。

输入 / 输出

方向	内容
输入	可选的 dry_run、可选的 runId、可选的 summaryArtifactPath
输出	结构化摘要信封，其中 summary_kind = env-cleanup、payload.status = completed / skipped / error，清理结果位于 changes / detail

传输输入：

• 独立运行：省略 runId 和 summaryArtifactPath
• 受管运行：传入 runId 和 summaryArtifactPath

运行时

运行时系列：environment-worker-runtime

阶段配置：

1. PHASE_0_CONFIG
2. PHASE_1_RESOLVE_CLAUDE_STATE
3. PHASE_2_REMOVE_HEXLINE_REGISTRATION
4. PHASE_3_REMOVE_HEXLINE_ARTIFACTS
5. PHASE_4_VERIFY_CLEANUP
6. PHASE_5_WRITE_SUMMARY
7. PHASE_6_SELF_CHECK

运行时规则：

• 发出 summary_kind=env-cleanup
• 独立运行会生成自己的 run_id，并写入默认的工作器系列工件路径
• 受管运行必须提供 runId 和 summaryArtifactPath，并且必须将摘要写入指定的确切路径
• 终止前始终写入通过验证的摘要工件

输出契约

始终按照以下契约构建结构化的 env-cleanup 摘要信封：

• references/coordinator_summary_contract.md
• references/environment_worker_runtime_contract.md

载荷字段：

• mcp_removed
• permissions_cleaned
• hooks_removed
• output_style_removed
• verification
• status

移除内容

界面	位置	操作
MCP 注册	claude mcp list / 用户范围	如果存在，则通过 claude mcp remove -s user hex-line 移除 hex-line 注册
权限条目	~/.claude/settings.json 和 ~/.claude/settings.local.json	移除目标为 mcp__hex-line__* 的 permissions.allow 条目
Hook 条目	~/.claude/settings.json 和 ~/.claude/settings.local.json	移除与当前 hex-line hook 特征匹配的 hook 条目
输出样式文件	~/.claude/output-styles/hex-line.md	删除文件
输出样式设置	~/.claude/settings.json 和 ~/.claude/settings.local.json	仅当值为 "hex-line" 时清除
Hook 目录	~/.claude/hex-line/	仅在工件清理后目录为空时删除

工作流

阶段 1：解析 Claude 状态

1. 如果 ~/.claude/settings.json 存在，则读取它
2. 如果 ~/.claude/settings.local.json 存在，则读取它
3. 检测：
   • 用户范围内的 hex-line MCP 注册
   • 针对 mcp__hex-line__* 的 permissions.allow 条目
   • 命令指向已安装的 hex-line hook 的 hook 条目
   • outputStyle = "hex-line"
   • 已安装的样式文件和 hook 目录
4. 在修改任何内容之前，准确记录哪些自有界面存在

阶段 2：移除 Hex-Line 注册

1. 如果用户范围内存在 hex-line 注册，则运行：

claude mcp remove -s user hex-line

2. 如果注册已不存在，则报告 already removed
3. 不要在此处卸载 npm 包。此工作器仅负责 Claude 端的集成界面

阶段 3：移除 Hex-Line 残留

1. 更新 Claude 设置界面：
   • 移除 permissions.allow 中的 mcp__hex-line__* 条目
   • 移除命令包含当前 hex-line hook 路径的 hook 条目
   • 移除空的 hook 事件数组；仅当 hooks 为空时才移除它
   • 仅当 outputStyle 的值恰好为 "hex-line" 时才清除它
2. 如果 ~/.claude/output-styles/hex-line.md 存在，则删除
3. 如果 ~/.claude/hex-line/hook.mjs 存在，则删除
4. 仅当移除文件后 ~/.claude/hex-line/ 为空时才删除该目录

规则：

• 保留所有非 hex-line 设置
• 除非存在明确的缓存删除步骤，否则绝不声称已清理缓存
• 不要触碰无关的 MCP 注册项或权限条目

阶段 4：验证清理结果

确认：

• 不再存在用户级别的 hex-line MCP 注册项
• 没有 permissions.allow 条目指向 mcp__hex-line__*
• 受管理的 Claude 设置文件中不再有 hex-line hook 条目
• outputStyle 不为 "hex-line"
• ~/.claude/output-styles/hex-line.md 不存在
• ~/.claude/hex-line/hook.mjs 不存在

备注

• 此工作器仅移除 Claude 端的 hex-line 集成
• 不会移除 npm 包本身
• 可以安全地多次运行

完成定义

• 已移除或确认不存在 Claude 用户级别的 hex-line MCP 注册项
• permissions.allow 不再包含 mcp__hex-line__*
• 受管理的 Claude 设置文件中不再有 hex-line hook 条目
• 已清除归其所有的 outputStyle: "hex-line"
• 已移除已安装的样式和 hook 残留
• 已返回结构化摘要
• 已将摘要残留写入受管理或独立运行时路径

版本： 1.0.0 最后更新： 2026-03-27