跳到正文
cccskills
免费在 GitHub 公开

encoding-touched-guard

快速編碼防災工作流。USE FOR:任何會修改 .md / .json / .ts / .js / .ps1 等文字檔的工作。目標是在每次編輯後立即檢查 touched files 是否出現 UTF-8 BOM、U+FFFD 或 mojibake,並在收工前再檢查一次,避免中文檔被整檔寫壞後才在 pre-commit 才發現。

中文简介正在准备中。当前显示原文说明。

查看安装方法

包含的文件(1)

  • SKILL.md2.3 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

Encoding Touched Guard

這個 skill 是給所有 Agent 的超快編碼自檢流程。

重點不是取代 pre-commit,而是把檢查前移,讓你在「剛改完檔案」就能立刻發現中文亂碼、BOM 或 mojibake,而不是等到最後提交才爆炸。

何時使用

只要這輪有改到任何高風險文字檔,就要用:

  • .md
  • .json
  • .ts
  • .js
  • .ps1

特別是:

  • 任務追蹤文件
  • 中文密集文件
  • 含中文註解 / template string 的程式檔

標準流程

1. 編輯後立刻跑一次 touched-files 快檢

npm run check:encoding:touched -- --files <file...>

這一步只掃你這輪剛改的檔案,適合多人協作時每次寫完就跑。

若你確認目前 dirty working tree 都是自己這輪的內容,也可以直接跑:

npm run check:encoding:touched

2. 若失敗,先停下來修

常見原因:

  • UTF-8 BOM
  • U+FFFD
  • 典型 mojibake

這時不要繼續做新改動,先把壞檔修回來,再繼續。

3. 收工前再跑一次

在你準備結束這輪、交接、或準備 commit 前,再跑一次:

npm run check:encoding:touched -- --files <file...>

4. commit 前仍由 staged 檢查硬擋

若你要手動檢查 staged files,可用:

npm run check:encoding:staged

為什麼不是只在最後檢查一次

  • 太晚發現時,很難知道是哪一步把中文寫壞。
  • 中途若有多次自動改寫,回溯成本會很高。
  • 這和 Unity Prefab / YAML 很像:不是最後才知道壞了,而是要盡量在第一時間抓到。

配套原則

  • touched-files 快檢:每次編輯後跑,成本最低。
  • 收工前快檢:避免漏網之魚。
  • pre-commit staged 檢查:最後硬保底。

三層一起上,才是正式流程。

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

Deterministic external-evidence web validation workflow for Sanguo ETL/RAG. USE FOR: 外部證據網站檢查、來源健康度、allowlist 驗證、來源 seed 覆蓋、3kweb-check、external evidence source health、fetch/parse/hash first、LLM reviewer second。

中文简介正在准备中。当前显示原文说明。

eaglhuang/3klife32026年10月22日 更新

Use when the user asks to switch AI role/mode/persona or uses role-trigger words such as Captain, Coordinator, 寫文章, 寫文章模式, 文章模式, 技術文章, 部落格, 出版, 預覽. Routes the request to Project Captain, Publishing Director, or Article Writing Mode, loads the matching keep memory when available, and applies the role's workflow without excessive roleplay.

中文简介正在准备中。当前显示原文说明。

eaglhuang/3klife32026年10月22日 更新

Write or revise AI-learning-notes article pages in "寫文章模式" when the user asks for articles, technical articles, blog posts, bilingual versions, article formatting consistency, shared article-base alignment, responsive layout, summary/TOC decisions, contrast, or publishing-flow compatibility.

中文简介正在准备中。当前显示原文说明。

eaglhuang/3klife32026年10月22日 更新

Plan ATM framework refactors by preserving atom/map semantics before splitting large governance modules.

中文简介正在准备中。当前显示原文说明。

eaglhuang/3klife32026年10月22日 更新

Captain 派工規範與決策手冊。當 AI 進入隊長模式或進行派工/派任務語境時,遵照這套標準,產出可供人類直接轉貼、高度結構化、符合 token 經濟且能動態適應可用 Roster 的派工單。

中文简介正在准备中。当前显示原文说明。

eaglhuang/3klife32026年10月22日 更新

Create and register an atom through the provisioning facade.

中文简介正在准备中。当前显示原文说明。

eaglhuang/3klife32026年10月22日 更新

查看 eaglhuang 的全部技能

报告此技能的问题