القائمة
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.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف 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: ...
风险：<已知风险和缓解措施>
状态：进行中 | 已完成