SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场ln-015-hex-line-uninstaller

ln-015-hex-line-uninstaller

部署与运维

查看项目

更新于 10-16 09:21

技能介绍

用途

ln-015-hex-line-uninstaller 是一个 L3 Worker 技能，分类为 0XX Shared，用于移除 Claude 侧的 hex-line 集成表面。它直接从配置文件与 CLI 状态中清理 Claude 侧状态，且可独立运行，也支持 ln-010 家族托管传输。缺少 MCP 连接不是阻塞条件，可继续尽可能进行本地清理与验证。

主要能力（移除内容）

  • 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 条目。
  • 钩子条目：位于 ~/.claude/settings.json 与 ~/.claude/settings.local.json，移除匹配当前 hex-line 钩子签名的 hook 条目。
  • 输出样式文件：删除 ~/.claude/output-styles/hex-line.md。
  • 输出样式设置：位于 ~/.claude/settings.json 与 ~/.claude/settings.local.json，仅当值为 "hex-line" 时清除。
  • 钩子目录：仅当产物清理后为空时删除 ~/.claude/hex-line/。

使用方式

输入：可选 dry_run、可选 runId、可选 summaryArtifactPath。 输出：结构化 summary envelope，summary_kind = env-cleanup，payload.status = completed / skipped / error，并在 changes / detail 中给出清理结果。 传输输入：standalone 模式省略 runId 与 summaryArtifactPath；managed 模式同时传入 runId 与 summaryArtifactPath。

运行时家族为 environment-worker-runtime，阶段配置包括：PHASE_0_CONFIG、PHASE_1_RESOLVE_CLAUDE_STATE、PHASE_2_REMOVE_HEXLINE_REGISTRATION、PHASE_3_REMOVE_HEXLINE_ARTIFACTS、PHASE_4_VERIFY_CLEANUP、PHASE_5_WRITE_SUMMARY、PHASE_6_SELF_CHECK。

运行时规则：发出 summary_kind=env-cleanup；standalone 运行自行生成 run_id 并写入默认 worker-family 产物路径；managed 运行要求同时提供 runId 与 summaryArtifactPath，且必须将摘要写入所提供的确切路径；始终在最终结果前写入经过验证的摘要产物。

输出契约：始终按 references/coordinator_summary_contract.md 与 references/environment_worker_runtime_contract.md 构建结构化 env-cleanup 摘要 envelope。Payload 字段包括：mcp_removed、permissions_cleaned、hooks_removed、output_style_removed、verification、status。

工作流程

Phase 1 解析 Claude 状态：读取 ~/.claude/settings.json（若存在）、读取 ~/.claude/settings.local.json（若存在）；检测用户作用域中的 hex-line MCP 注册、针对 mcp__hex-line__* 的 permissions.allow 条目、命令指向已安装 hex-line 钩子的 hook 条目、outputStyle = "hex-line"、已安装的样式文件与钩子目录；在修改任何内容前准确记录存在哪些自有表面。

Phase 2 移除 hex-line 注册：若存在用户作用域 hex-line 注册，运行 claude mcp remove -s user hex-line；若注册已不存在，报告已移除。此处不卸载 npm 包，该 worker 仅负责 Claude 侧集成表面。

Phase 3 移除 hex-line 产物：更新 Claude 设置表面——移除针对 mcp__hex-line__* 的 permissions.allow 条目；移除命令包含活动 hex-line 钩子路径的 hook 条目；移除空的 hook 事件数组，并仅在 hooks 为空时移除 hooks；仅当 outputStyle 恰为 "hex-line" 时清除；删除 ~/.claude/output-styles/hex-line.md（若存在）；删除 ~/.claude/hex-line/hook.mjs（若存在）；仅当文件移除后目录为空时删除 ~/.claude/hex-line/。规则：保留所有非 hex-line 设置；除非存在具体的缓存删除步骤，否则绝不声称清理了缓存；不触碰无关的 MCP 注册或权限条目。

Phase 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 集成表面的情况，例如 MCP 注册、权限、钩子与输出样式。

限制

该 worker 仅移除 Claude 侧 hex-line 集成，不卸载 npm 包本身；可安全重复运行。

完成定义

  • Claude 用户作用域 hex-line MCP 注册已移除或确认不存在
  • permissions.allow 不再包含 mcp__hex-line__*
  • 受管 Claude 设置文件中不再残留 hex-line hook 条目
  • 在自有范围内清除 outputStyle: "hex-line"
  • 已安装的样式与钩子产物已移除
  • 返回结构化摘要
  • 摘要产物写入受管或 standalone 运行时路径

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