Clipboard Output Skill

在基于文本的用户界面（TUI）中使用 AI 编码助手（如 Codex）时，从终端复制生成的代码、配置或 JSON 往往伴随着令人头疼的格式问题——左侧多余的空格、缩进错乱或选中困难。Clipboard Output Skill 是一个专为 Codex 设计的个人技能（Skill），旨在将生成内容精准、干净地放入系统剪贴板。

它不仅仅是一个复制工具，更是一个具备安全感知和智能判断能力的剪贴板管家。

核心亮点：精准、安全、智能

1. 零格式污染，精准复制

• 消除空格干扰：直接通过系统 API 写入剪贴板，避免手动选择文本时带入终端左侧的行号或空格。
• 适用场景广泛：完美处理脚本、配置文件、Prompt、JSON、Markdown、命令行指令、Issue 正文及 Release Note 等多行文本。

2. 默认拒绝敏感内容

• 启发式检测：自动识别并拒绝复制疑似敏感信息，包括 API Key、Token、密码、私钥等。
• 安全优先：除非用户显式使用 --allow-sensitive 参数，否则敏感内容将被拦截，防止意外泄露至系统共享剪贴板。

3. 智能多文件处理

• 入口提取：当生成多个文件时，Skill 会先将其写入磁盘，然后智能判断并复制“最有用的入口”——如主执行脚本、目录路径、运行命令或 Manifest 文件。
• 按需合并：仅在用户明确要求“合并成一段可粘贴文本”时，才会将多文件内容合并输出。

4. 全平台后端适配

Helper 脚本能自动检测当前环境并选择最佳剪贴板后端：

• Windows: 原生 Win32 API (ctypes) 或 clip.exe
• macOS: pbcopy
• Linux (Wayland): wl-copy
• Linux (X11): xclip 或 xsel
• WSL: PowerShell Set-Clipboard (回退至 clip.exe)
• Termux: termux-clipboard-set

快速开始

1. 安装 Skill

mkdir -p ~/.agents/skills
cp -R skills/clipboard-output ~/.agents/skills/clipboard-output

重启或重载 Codex 以生效。

2. 验证环境

检查 Helper 是否能正确检测剪贴板后端：

python3 ~/.agents/skills/clipboard-output/scripts/copy_text.py \
  --file ~/.agents/skills/clipboard-output/SKILL.md \
  --dry-run

使用指南

1. 从文件复制

python3 ~/.agents/skills/clipboard-output/scripts/copy_text.py --file ./script.bat

2. 复制短文本

python3 ~/.agents/skills/clipboard-output/scripts/copy_text.py --text "hello world"

3. 从标准输入复制

printf '%s\n' "import os" | python3 ~/.agents/skills/clipboard-output/scripts/copy_text.py --stdin

4. 强制复制敏感内容（慎用）

python3 ~/.agents/skills/clipboard-output/scripts/copy_text.py --file ./.env --allow-sensitive

技术架构与安全说明

• Skill 格式：遵循 Codex personal skill 规范 (SKILL.md)。
• Helper 运行时：Python 3.12+ 标准库，无第三方依赖，轻量高效。
• 测试覆盖：提供完整的 unittest 测试套件，覆盖输入来源、敏感检测及各平台后端逻辑。
• CI/CD：集成 GitHub Actions 确保代码质量。

⚠️ 安全提示：

剪贴板是系统级共享状态，任何应用均可读取。尽管 Helper 提供了敏感内容检测，但这仅是启发式的。严禁将生产环境密钥、客户数据或高度机密日志放入剪贴板，除非你完全信任当前系统环境。