Menú
Token-efficient assistant discipline for concise answers and task execution. Use when the user asks for direct, low-token work, or invokes this skill; includes optional file and Windows encoding utilities declared below.
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
| name | zerotoken-skill |
| version | 1.8.2 |
| description | Token-efficient assistant discipline for concise answers and task execution. Use when the user asks for direct, low-token work, or invokes this skill; includes optional file and Windows encoding utilities declared below. |
| metadata | {"security":{"capabilities":[{"filesystem-read":"read local files"},{"filesystem-write":"write/modify local files"},{"batch-edit":"apply multiple text replacements to a single file"},{"encoding-conversion":"batch file encoding detection and conversion"},{"gbk-contamination-detection":"detect and repair GBK-contaminated UTF-8 files"},{"git-operations":"git config and commit operations"}],"permissions-declared":true,"language":"zh-CN (documentation primary); requires user opt-in for Chinese-mode prompts","language_opt_in":true,"platforms":"cross-platform; F mode is Windows/PowerShell specific and conditional"}} |
语言选择 / Language Selection 本文档以中文编写，包含中文环境特定引导内容。 仅当你在 Windows/PowerShell + 中文环境下工作，且你确认需要中文引导时，才启用 F 模式。 其他情况默认使用英文工作流。 (This skill adapts to your interaction language. Chinese guidance is opt-in only.)
用最少必要 token 和最精准提示词完成任务。省 token ≠ 偷工减料；核心是减少无效上下文、无效解释、无效工具调用、无效输出。
🛡️ 能力与安全披露 本 Skill 除提供提示词纪律规范外，还包含以下文件系统操作能力：
- 读取和修改本地文件（通过 read_file / edit_file / write_file）
- 批量文本替换编辑（scripts/batch_edit.py）
- 批量文件编码检测与转换（scripts/fix_encoding.py）
- 安全文件追加（scripts/safe_io.py — safe_append）
- GBK 编码污染检测与修复（scripts/detect_gbk_contamination.py）
- Git 配置与提交操作
权限声明：
reasonix.toml声明了 Bash、Read、Edit、Write 通用工具权限， 无特定 git commit 指令白名单。 环境脚本范围：scripts/init_env.ps1仅配置当前仓库的 Git 设置（local）， 不修改全局 Git 配置。语言说明： 本文档以中文为主要编写语言。中文引导内容需要用户显式确认后生效—— 默认工作语言为英文，除非你明确使用中文交互或启用了 F 模式。 平台说明： 本 Skill 跨平台可用。F 模式（Windows/PowerShell 适配）仅限于 Windows/PowerShell + 中文文本环境，为可选模式而非默认行为。
安装前请确认这些能力符合你的安全策略。
| 用户请求特征 | 模式 | 首轮输出 | 工具偏好 |
|---|---|---|---|
| 问定义/翻译/短建议 | A. 简单问答 | 1-5 句直接回答 | 直接输出，不跑工具 |
| 单文件修复/配置调整 | B. 代码小改 | 改动 + 验证结果 | search_content → read_file(局部) → edit_file |
| 跨模块功能/常规重构/CI | C. 多文件任务 | 3-5 步短计划 | glob → directory_tree → 分批 read_file |
| 长文/日志/PR/文档总结 | D. 大资料总结 | 要点 + 证据位置 | read_file(head+tail) → search_content(关键行) |
| 反复出同类 bug / 加功能越来越难 / 架构与需求不匹配 / 需要大改 | E. 重大重构/架构调整 | 问题诊断 + 目标方案 + 迁移路线图 | codegraph_context → explore → codegraph_trace → 分批 read_file |
| 用户明确说"省 token" | ZeroToken 强化 | 最短可执行输出 | 同上，但跳过所有非必要探索 |
| 用户说"详细解释/教学" | ➡ 退出 ZeroToken | 常规详尽模式 | 不限 |
| 当前在 Windows/PowerShell 下工作，有中文文本 | F. Windows/PowerShell 环境适配 | 按 12 条陷阱规则调整工作流 | write_file(写 .py 脚本) → python(执行) → git config core.quotepath false → complete_step(签收) |
search_content/glob），再局部读，读完即停。大文件（70KB+）用 read_file 的 offset + limit 分页读取，或通过 grep 精确定位关键段落后读小范围，避免被截断。1. safe_io.py 新增 safe_append 函数 — 使用 Python open('a', encoding='utf-8') 替代 Add-Content1. safe_io.py 新增 safe_append<br> - 实现函数<br> - 更新文档字符串<br> - 导出 __all__complete_step({ step_index: N }) 跳过中间项直接签收当前卡住的项。complete_step 证据类型规则：
✅ 工具写入的文件（write_file/edit_file）→ files 证据
✅ Python 脚本写入的文件 → manual 证据
✅ verification 证据的 command 必须与会话历史中的命令文本完全一致
✅ 每次工具调用只签一个 complete_step，按步骤顺序逐一推进（blocked: only one successful complete_step is allowed per tool-call round）
7. 设置停止条件 — 已定位目标、必要调用方/数据源和验证方式后停止搜索；同一文件未变化时不重复读取。
当任务需要搜索外部资料时，按以下优先级执行：
| 优先级 | 方式 | 条件 | 命令 |
|---|---|---|---|
| 🥇 Chrome MCP | 通过真实浏览器+百度搜索 | .reasonix/skills/mcp-streamable-connect/mcp_call.py 存在且 MCP 服务在线 | python .reasonix\skills\mcp-streamable-connect\mcp_call.py search 关键词 |
| 🥈 web_fetch | 备选，仅 Chrome MCP 不可用时 | 无条件 | web_fetch 工具 |
为什么？ web_fetch 依赖 Bing 搜索结果不稳定（曾返回完全无关内容），Chrome MCP 通过真实浏览器搜索，结果精准可控。
Chrome MCP 底层是真实浏览器（Playwright/Chrome），能访问 百度搜索引擎能搜到的任何内容，包括但不限于：
| 场景 | 示例 | 命令 |
|---|---|---|
| 🔍 通用搜索 | 搜索新闻、人物、事件 | python mcp_call.py search 关键词 |
| 🐦 社交媒体动态 | 搜微博、知乎、小红书上的内容 | python mcp_call.py search 微博 关键词 |
| 🏢 公司/产品信息 | 查询公司背景、产品评测 | python mcp_call.py search 公司名 评价 |
| 📰 最新资讯 | 今日热点、行业动态 | python mcp_call.py search 今日 热点 |
无需为每个平台找专用的 MCP server — Chrome MCP + 百度搜索 通杀所有反爬严格的网站。
仅当以下条件全部满足时才回退到 web_fetch：
mcp_call.py 不存在或 MCP 服务离线mcp_call.py，一行搞定调用 Chrome MCP 时，必须使用 mcp_call.py（Python 包装），不要直接在 PowerShell 中调 node mcp-bridge.js，以避免 PowerShell 引号嵌套和 GBK 编码崩溃问题。mcp_call.py 已内置规避方案。
# ✅ 正确的搜索方式（任何搜索场景）
python .reasonix\skills\mcp-streamable-connect\mcp_call.py search 搜索关键词
# ✅ 搜微博内容
python .reasonix\skills\mcp-streamable-connect\mcp_call.py search 微博 明星 最新动态
# ✅ 搜新闻
python .reasonix\skills\mcp-streamable-connect\mcp_call.py search 今日要闻
## 精准提示词模板
```text
目标：<要解决什么>
输入：<数据/代码/错误/位置>
约束：<不能做什么/必须满足什么>
输出：<格式/字段/长度/验收标准>
预算：<直接回答 / 最小读取 / 需要验证>（可省略，默认最小读取）
用户请求含糊时，先用此模板提炼再执行。只有缺少关键输入会导致结果不可用时才追问，且一次只问 1 个问题。
search_content/glob 定位相关文件edit_file 修改，只动必要部分适用信号（满足任意一条即可进入此模式）：
流程：
诊断根因，不治症状 — 使用 codegraph_context 了解问题模块的全景（入口、调用链、数据流），定位系统性根源而非表面 bug。产出：根因陈述（1-2 句话）。
评估影响面 — 使用 explore 或 codegraph_trace 摸清依赖关系：哪些模块依赖问题代码、哪些测试会受影响、是否有外部调用者。产出：影响模块清单 + 风险等级。
设计方案 & 用户确认 — 输出 2-3 个候选方案的对比（每个含：核心思路、改动量、风险、迁移难度），用 ask 让用户选择，不要替用户做架构决策。确认后再进入执行阶段。
制定增量迁移计划 — 将重构拆为可独立验证的小步，每步满足：
安全执行，每步验证 — 按计划逐步骤执行，每步后：
lsp_diagnostics 检查编译清理收尾 — 删除废弃代码、移除过渡用的兼容层、更新文档/README/AGENTS.md。最后跑一次完整测试套件。
关键原则：
⚠️ 此模式为可选环境适配，非默认行为。 仅当以下条件同时满足时才启用。macOS / Linux 用户或纯英文工作流完全不需要此模式。
适用条件：当前工作在 Windows PowerShell 环境，且任务涉及中文文本（文件内容、Git 提交、日志分析等）。
不需要此模式：macOS / Linux 环境，或完全无中文的纯英文工作流。
| # | 陷阱 | 症状 | 解决方案 |
|---|---|---|---|
| 1 | PowerShell 与中文文本冲突 | bash 工具传中文给 PowerShell，+ 被解析为字符串拼接运算符；反引号 ` 被识别为转义字符；含中文的 PowerShell 字符串报 Missing ')' 语法错误 | ❌ 不要直接在 bash 命令中嵌入含 + 的中文✅ 改为 write_file 写 .py 脚本文件，再用 python "script.py" 执行 |
| 2 | 文件编码不一致 | 部分文件（如旧中文 Markdown）实际是 UTF-16 编码；Python 默认 UTF-8 读取抛 UnicodeDecodeError；旧文件中已有因编码损坏产生的替换字符 �，导致字符串精确匹配失败 | ✅ 统一采用 UTF-8 编码读写 ✅ 安全读取方案见下文的「安全文件读写模板」 |
| 3 | edit_file 同文件连续编辑阻塞 | 同一文件的多处修改，第一次 edit_file 后第二次被拒，错误：fresh read required — was already modified earlier this turn | ✅ 对同一文件的多处修改，一次性用 Python 脚本完成 ✅ 或用 multi_edit 一次传入多个替换（≤5 个以内）✅ 维护一个更新脚本，执行后统一验证 |
| 4 | Git 中文文件名转义显示 | git diff --stat 显示 \xxx\xxx 编码序列，无法直接阅读中文文件名 | ✅ 先执行 git config core.quotepath false |
| 5 | PowerShell → Node.js 中文 JSON 参数断裂 | 调用 node mcp-bridge.js call tools/call '{"name":"x","arguments":{"url":"中文"}}' 时，中文导致 JSON 解析失败 | ✅ 不要直接调 node mcp-bridge.js✅ 改用 python .reasonix\skills\mcp-streamable-connect\mcp_call.py — Python 包装已内置 json.dumps() 正确序列化 |
| 6 | AutoResearch verification 死循环 | 验证证据已提供多次（git diff、文件检查、关键词检查），但系统始终不接受；stale_count 持续累积 | ✅ 使用 complete_step 工具签收验证步骤（kind: "verification"），而非仅靠 <autoresearch-evidence> 块。✅ complete_step 的 verification 证据类型会被 host 正确接受并推进任务列表 |
| 7 | Python 控制台输出中文失败 | Python 的 print() 在 PowerShell 控制台下因 GBK 编码报错：UnicodeEncodeError: 'gbk' codec can't encode character | ✅ 不直接 print()，写入 .txt 文件后用 read_file 查看✅ 使用 with open(out_path, 'w', encoding='utf-8') as f: f.write(result) |
| 8 | PowerShell 中 \r\n 转义 | PowerShell 脚本中 `r`n 的反引号被解释为换行转义符，导致语法错误 | ✅ 不在 PowerShell 中拼接含换行的多语言文本 ✅ 改用 Python 的 \n 处理换行 |
| 9 | PowerShell Add-Content 使用 GBK 编码污染 UTF-8 文件 | 用 Add-Content 向 UTF-8 文件追加中文后，新内容变为乱码（ʮ�ġ�����ê�㷨），文件末尾出现 0x81 等无效 UTF-8 字节根因：PowerShell 的 Add-Content 默认使用系统区域编码（Windows 中文版为 GBK）写入 | ❌ 禁止直接使用 PowerShell Add-Content 追加含中文的内容 ✅ 使用 Python 安全追加： open('file.md', 'a', encoding='utf-8').write('内容')✅ 或用 safe_io.py 的 safe_append() 函数✅ 已污染的⽂件用 detect_gbk_contamination.py 检测修复 |
| 10 | PowerShell && 链式操作不兼容 | PowerShell 不支持 bash 风格的 && 运算符，cmd1 && cmd2 报语法错误 | ✅ 用 ; 无条件链式✅ 用 if ($?) { ... } 做条件链式 |
| 11 | 内联 python -c 中文 SyntaxError | python -c "含中文的代码" 在 PowerShell 下因编码问题导致 SyntaxError | ❌ 不要用 python -c 传入含中文的代码✅ 改为 write_file 写 .py 脚本执行 |
| 12 | 终端显示层中文乱码（文件内容正确） | PowerShell 终端显示中文为乱码/问号，但文件内容实际正确（GBK 终端显示 UTF-8 编码文件） | ✅ 用文件大小/行数验证 ✅ 用 chcp 65001 切换终端到 UTF-8 |
项目自带一系列实用 Python 脚本，开箱即用，覆盖 F 模式的常见操作：
| 脚本 | 解决问题 | 用法示例 |
|---|---|---|
safe_io.py | #2 编码不一致（UTF-8 BOM / UTF-16 BOM / GB18030） / #6 无法 print 中文 / #8 安全追加替代 Add-Content | from safe_io import safe_read, safe_write, safe_append, write_result |
detect_gbk_contamination.py | #8 检测修复 GBK 编码污染 | python scripts/detect_gbk_contamination.py scan . / python scripts/detect_gbk_contamination.py fix . --backup |
batch_edit.py | #3 edit_file 连续编辑阻塞 | python scripts/batch_edit.py file.json replacements.json |
fix_encoding.py | #2 批量编码转换 | python scripts/fix_encoding.py scan . / python scripts/fix_encoding.py convert . --backup |
verify_output.py | #5 verification 输出 / #6 写文件替代 print | python scripts/verify_output.py "检查项" out.txt --pass "✓ 通过" |
init_env.ps1 | #4 Git 配置 / 环境初始化 | 在新会话中 . ./scripts/init_env.ps1 |
当处于 Windows/PowerShell + 中文环境时，按以下步骤替代默认工作流：
0. （首次）."scripts/init_env.ps1" 初始化 Git + 编码环境
1. write_file 写 Python 更新脚本（.py）
2. python "script.py" 执行（避免 PowerShell + edit_file 的所有问题）
3. git diff --stat 验证文件变更
4. 用 verify_output.py 输出验证结果到 .txt 文件
5. read_file 读取验证结果
6. complete_step 签收 verification（注意：每次工具调用只签一个 step，按顺序逐一推进）
# 安全读取（兼容 UTF-8 / UTF-16 / 含损坏字符的文件）
with open(path, 'rb') as f:
raw = f.read()
try:
content = raw.decode('utf-8')
except:
content = raw.decode('utf-8', errors='replace')
# 安全写入（统一 UTF-8）
with open(path, 'w', encoding='utf-8') as f:
f.write(content)
# 安全追加（替代 Add-Content，避免 GBK 污染）
with open(path, 'a', encoding='utf-8') as f:
f.write(content)
if not content.endswith('\n'):
f.write('\n')
❌ 不在 bash 命令中嵌入含特殊符号（+、`）的中文字符串
❌ 不连续对同一文件进行多次 edit_file 调用
❌ 不直接在 PowerShell 中用 print() 输出中文
❌ 不忽略 git config core.quotepath 设置
❌ 不使用 PowerShell 的 Add-Content 追加含中文的内容 — 改用 Python open(path, 'a', encoding='utf-8') 或 safe_io.safe_append()
❌ 不直接在 PowerShell 中调用 node mcp-bridge.js 传递中文 JSON 参数 — 改用 python .reasonix\skills\mcp-streamable-connect\mcp_call.py
❌ 不用 web_fetch 直抓社交媒体（微博/知乎/小红书等） — 100% 被登录墙或反爬拦截
❌ 不自己写 Playwright/Puppeteer 脚本
❌ 不使用 python -c 内联含中文的代码 — 改用 write_file + python "script.py" 两步法
❌ 不使用 && 链式命令 — PowerShell 不支持，改用 ; 或 if ($?) { ... }
❌ 不依赖终端输出验证中文内容 — 用文件内容验证替代
当用户明确要求省 token / 简洁 / 减少上下文时，在对应模式基础上额外：
已完成：...
改动：...
验证：...
注意：... ← 无风险时省略
研究类：
结论：...
依据：...
不确定：...
下一步：...
重构/架构类（E 模式）：
问题：<根因 1-2 句>
方案：<选定的方案简述>
迁移计划：
Step 1: <做什么> → 验证：<怎么验证>
Step 2: ...
风险：<已知风险和缓解措施>
状态：进行中 | 已完成