auto hook (v4 · 跨平台 + 钩子撤销)

本 SKILL 支持两种模式，根据用户意图自动判断：

模式 A · 注入模式（默认）：定位 + 注入钩子

1. 定位：在当前智能体的标准路径中找到目标 SKILL.md
2. 读取钩子：读取 skill-audit-hook.txt 的完整内容作为注入内容
3. 钩子注入：检测末尾是否已有 autohook；若无则将文件内容追加到 SKILL.md 末尾

模式 B · 撤销模式：删除已注入的钩子，恢复 SKILL 原样

• 触发词含"停止/取消/删除/移除/关掉/撤销/还原/不用检查"等语义时自动切换
• 执行 Step R1–R4（见撤销流程章节）

附录 A · 各智能体 SKILL 路径速查表

本节供 Step 1 查找文件时参考，也可直接回答用户「skill 在哪里」的问题。

A1 · Claude Code（Anthropic）

优先级：项目级 > 个人全局 > 插件 > 内置捆绑。

⚠️ Windows WSL 已知问题：Claude Code 可能将 skill 写入 Windows 挂载的项目路径而非 Linux 用户路径。
修复：mkdir -p ~/.claude/skills && cp -r .claude/skills/* ~/.claude/skills/

A2 · OpenAI Codex CLI

优先级：项目级 > 用户全局 > 系统 > 内置（$skill-creator、$skill-installer）。

禁用而不删除，在 ~/.codex/config.toml 中：

[[skills.config]]
path = "/path/to/skill/SKILL.md"
enabled = false

⚠️ Windows 原生为实验性，建议在 WSL workspace 内使用。
Windows junction 替代 symlink：

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.agents\skills"
cmd /c mklink /J "$env:USERPROFILE\.agents\skills\myskill" "$env:USERPROFILE\.codex\myskill\skills"

A3 · OpenClaw

优先级：工作区级 > 用户全局 > extraDirs > 内置。

⚠️ Windows 限制：官方推荐优先使用 Mac 或 Linux；Windows 需通过 WSL2 运行。

A4 · claude.ai / Cowork（本 SKILL 原生环境）

优先级：user > public > examples（均为只读，修改后需输出文件供用户替换）。

A5 · 通用安装工具（skills.sh · Vercel 维护）

# 自动检测已安装智能体并路由到正确目录
npx skills add vercel-labs/agent-skills

# 只安装给指定智能体
npx skills add vercel-labs/agent-skills -a claude-code -a codex

# 搜索 skill
npx skills find "react testing"

# 更新所有已安装 skill
npx skills update

A6 · 公共注册表速查

Step 1 · 定位目标 SKILL 文件

从用户消息中提取 SKILL 名称（如 html-to-pptx）。

若当前环境为 claude.ai / Cowork，执行：

find /mnt/skills -path "*/<n>/SKILL.md" 2>/dev/null

找不到时列出所有可用：

find /mnt/skills -name "SKILL.md" | sed 's|/SKILL.md||' | xargs -I{} basename {}

若用户描述的是本地环境，根据附录 A 对应智能体告知路径，指导用户手动定位，无需执行 bash。

找到后用 view 完整读取（超 300 行必须 view_range 分段，不得截断）。

Step 2 · 读取 skill-audit-hook.txt

必须读取该文件作为注入内容，不得使用任何内置默认文本替代：

find /mnt/user-data/uploads -name "skill-audit-hook.txt" 2>/dev/null

找到后立即用 view 工具读取完整内容，将其全文保存备用。

若找不到该文件，停止执行并告知用户：

❌ 未找到 skill-audit-hook.txt，请先上传该文件后重试。

不得继续后续步骤，不得使用任何替代内容。

Step 3 · 钩子检查与注入

3a · 检测是否已有 autohook

在 SKILL.md 全文中搜索任意关键词：自审计 / autohook / 审计钩子 / debug.txt / ❌ 和 ⏭️

若找到：✅ 已检测到 autohook（行 XX–XX），无需插入。 → 结束本步骤。

3b · 注入钩子

未找到钩子，执行注入（内容必须来自 Step 2 读取的 skill-audit-hook.txt）：

cp <原始路径> /home/claude/<n>-SKILL.md

# Python 追加写入，确保内容完整无截断
with open('skill-audit-hook.txt', 'r') as f:
    hook = f.read()
with open('/home/claude/<n>-SKILL.md', 'a') as f:
    f.write('\n\n')
    f.write(hook)
print("钩子注入完成")

验证：

tail -20 /home/claude/<n>-SKILL.md
cp /home/claude/<n>-SKILL.md /mnt/user-data/outputs/<n>-SKILL.md

注入完成后调用 present_files，并告知用户按附录 A 对应路径替换原文件。

Step 4 · 输出摘要

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  SKILL 钩子报告 · <n>
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
【来源】skill-audit-hook.txt（已读取）
【钩子】✅ 已存在（行 XX）/ 🔧 已注入（请按附录A路径替换）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

注意事项

• /mnt/skills/ 为只读；所有修改在 /home/claude/ 完成后输出文件供用户替换
• 用户若描述本地环境，直接用附录 A 路径表回答，无需执行 bash
• 同时检查多个 SKILL 时，对每个依次执行 Step 1–5
• 钩子不重复注入：每次先做 4a 检测，有钩子则跳过 4b
• 钩子内容必须来自 skill-audit-hook.txt，不得使用内置默认文本

模式 B · 钩子撤销流程

触发条件：用户说「停止检查」「不用检查了」「取消 hook」「删除钩子」「移除自审计」
「关掉审计」「撤销钩子」「还原 XX skill」「去掉 autohook」等任意语义。

Step R1 · 定位目标 SKILL 文件

与模式 A Step 1 相同：从用户消息提取 SKILL 名称，按附录 A 路径查找，完整读取文件。

若用户未指定具体 SKILL，询问：「请问要从哪个 SKILL 中移除钩子？」

Step R2 · 定位钩子边界

在文件全文中搜索钩子起始标记（以下任意一个即为起始行）：

## ⚙️ 强制自审计
## ⚙️ 自审计钩子
---\n\n## ⚙️

同时搜索以下关键词确认是钩子内容（必须同时出现才判定为待删除区块）：

• debug.txt
• Step 1 · 提取规则 或 Step 1 · 读取钩子文件
• ❌ 和 ⏭️ 或 ❌ / ⏭️

若找不到钩子标记：

⚠️ 未在 <n> 中检测到 autohook，无需操作。

结束流程。

Step R3 · 删除钩子段落

方式一（claude.ai 环境，bash 可用）：

cp <原始路径> /home/claude/<n>-SKILL.md

用 Python 脚本精确删除，从钩子起始行（含前置 --- 分隔线）到文件末尾：

python3 << 'PYEOF'
with open('/home/claude/<n>-SKILL.md', 'r') as f:
    lines = f.readlines()

# 找到钩子起始位置（向上包含最近一个 --- 分隔线）
hook_start = None
for i, line in enumerate(lines):
    if '强制自审计' in line or '自审计钩子' in line:
        # 向上找最近的 --- 分隔线
        for j in range(i-1, max(i-5, 0)-1, -1):
            if lines[j].strip() == '---':
                hook_start = j
                break
        if hook_start is None:
            hook_start = i
        break

if hook_start is not None:
    # 删除从 hook_start 到文件末尾，并去除末尾多余空行
    cleaned = lines[:hook_start]
    while cleaned and cleaned[-1].strip() == '':
        cleaned.pop()
    cleaned.append('\n')  # 保留一个末尾换行
    with open('/home/claude/<n>-SKILL.md', 'w') as f:
        f.writelines(cleaned)
    print(f"已删除第 {hook_start+1} 行起的钩子段落")
else:
    print("未找到钩子，无操作")
PYEOF

验证删除结果：

tail -15 /home/claude/<n>-SKILL.md
grep -n "自审计\|autohook\|debug.txt" /home/claude/<n>-SKILL.md && echo "⚠️ 仍有残留" || echo "✅ 钩子已清除"

方式二（用户本地环境）：

告知用户手动删除：打开 SKILL.md，找到包含 ## ⚙️ 强制自审计 的段落（通常在文件末尾），
连同上方的 --- 分隔线一起删除到文件结尾，保存即可。

Step R4 · 输出与交付

cp /home/claude/<n>-SKILL.md /mnt/user-data/outputs/<n>-SKILL-clean.md

调用 present_files 提供下载，并告知用户：

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  钩子撤销报告 · <n>
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
【操作】已删除 autohook（原第 XX 行起）
【文件】<n>-SKILL-clean.md（请按附录 A 路径替换原文件）
【状态】✅ SKILL 已恢复原样，不再触发自审计
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━