yuchiBLOCK
让中文写得有呼吸——人和 AI 都用得上的一把写作尺:写作节奏诊断 + 诗词语联体检 + 十四篇教材
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
原作者:ZhongQuinnKing(主号署名) 许可:见 LICENSE(内容 CC BY-NC-ND 4.0)与 LICENSE-CODE(代码 MIT)(五档:免费用/自改自由/转发署名/改版发布先授权/商用零豁免) 商用与合作:请先联系(通道:本仓库 issue,标题注明【商用授权】或【改编授权】)
「仙人持玉尺,度君多少才。」 ——旧题李白《上清宝鼎诗》(作者有考证争议,《全唐诗》补遗收入李白名下)
把一段文字贴进来,玉尺说出哪里读起来“不像人写的”,指到句子,告诉你怎么改。量的是节奏,不是词表。
玉尺做两件事,同等对待:把文章写好,和把诗写好。文章与诗不分主次,各求各的领域最强。
English TL;DR — Yuchi (“jade ruler”) is a rhythm-based diagnostic for Chinese writing: sentence-length breathing, filler and cliché density, structure. It points at the exact sentences that read machine-like and shows how to fix them. Ships as CLI, a web page, and an AI skill pack. Chinese-first.
这是什么
中文写作里,“机器味”从来不是几个词的错。真正的分界在结构:句子的长短起伏、连接词的分量、段落是推进还是平铺。玉尺把那道分界量成数:
- 节奏层:句长呼吸、句内节奏、平滑段定位
- 密度层:套话与连接词、破折号、虚词与空夸词
- 结构层:清单式还是推进式
- 具体层:形容词有没有落到数字、动作、场面
- 段落层:段落参差度
量完给三样:分数(有气 / 气弱 / 气滞 / 无气)、问题定位、落到句子的改法。
作诗方向(与写作同标准推进):诗模式已能体检——贴一首诗,看行长呼吸、逐字平仄标注与读感(“连着四个仄声,念起来发紧”这类);「景到诗」在建设中——把眼前的溪流与蓝天简单描绘,得到合心意的句子;近体诗、词、曲、联、赋五类已都能体检(词:818 词牌对谱;曲:中原音韵声调与韵脚;联:四验;赋:四六骈句报数与句末韵部)。
三件套
- 网页版:打开就能量,贴文字出诊断卡(
web/index.html,可直接挂 GitHub Pages) - 命令行:
python3 yuchi.py 你的文章.txt(零依赖,纯标准库;另有--poem诗、--ci 词牌词、--qu曲、--lian联、--fu赋、--html报告卡、--json结构化输出、--batch多文件对照) - 技能包:
SKILL.md加十五篇教材,装进 Claude、豆包等 AI 助手——AI 写中文、改中文时按它办
在线试用(不用装):https://zhongquinnking.github.io/yuchi/
怎么装
AI 助手(技能包)
- 豆包等:对它说一句“请安装这个 skill:https://github.com/ZhongQuinnKing/yuchi”
- Claude Code / Codex:
git clone https://github.com/ZhongQuinnKing/yuchi ~/.claude/skills/yuchi - 其他一线 AI(ChatGPT / Kimi / 通义 / 元宝 / 智谱 / Gemini / DeepSeek...):把仓库喂进它的知识库/智能体,或直接发仓库地址请它自装(仓库带
AGENTS.md——Codex 这类读它的助手,进目录即懂规矩)
命令行 / 网页:clone 下来即用,无需安装任何东西。
给 AI 用户的开口模板(详见 references/10-AI协作.md):
请你写一篇(标题与用途:_)。料(用这些素材,一个字不许编):。谱(照着写):每 200 字至少一句十二个字以内的短句;不许用“首先、其次、最后”串联;不许出现“值得注意的是、综上所述”;破折号全文最多两处;形容词尽量换成数字、动作、例子。样子(语气参考):_。完事后自查一遍,把没过的项报给我。
边界(先说清楚)
- 不测 AI 率,不承诺检测数字。“
25f6fd5b5af9OBSERVED · 2026-10-14Install
Commands as the repository documents them. They are shown, not run.
git clone https://github.com/ZhongQuinnKing/yuchi && cd yuchi
git clone https://github.com/ZhongQuinnKing/yuchi
Host compatibility
What the documentation claims. We have not run a compatibility test.
| Host | Status | Notes |
|---|---|---|
| claude-code | mentioned | |
| codex | mentioned | |
| cursor | mentioned |
What it tells the agent
The instruction file, verbatim from the audited commit — this is the text the model reads, and the surface the audit's instruction layer examines. Quoted here so you can judge it without cloning anything.
--- name: yuchi description: 玉尺——中文写作与作诗的呼吸。当用户请你写中文内容(文章、报告、公众号、文案、帖子、邮件、总结),或请你作诗、改诗(近体诗、现代诗、词、曲、对联、赋、歌词),或修改、润色、评价中文文字时使用。核心是一套可执行的写作硬律:句长有呼吸、连接词限额、结构不许平铺、写完全文自检;写诗另有体检(行节奏、平仄读感)。目的是让写出来的中文带着人的节奏,读起来不像机器写的。 --- # 玉尺 · 中文写作的呼吸 中文写作里,“机器味”从来不是几个词的错。词表可以背、可以删,删了旧的还有新的。 真正的分界在结构:**句子的长短起伏、连接词的分量、段落是推进还是平铺**。 这份技能把那条分界落成十条可执行的硬律,你写的时候逐条办,写完逐条查。 (依据:句长节奏是 AI 文本最强判别特征,多项研究以“句长变化加标点密度”达到 96% 至 98% 的判别率;有效改写必须动结构,只换同义词几乎无效。) ## 一、十条硬律(写作时逐条遵守) 1. **句长要有呼吸**。每 200 字至少安排一句十二个字以内的短句;不允许连续三句长度相近(相差不到三字)。长句群中间要留短的落点。 2. **连接词限额**。“因此、然而、首先、其次、最后、此外、更重要的是”这类,全文合计每百字不超过一个。因果关系交给语序,转折交给短句。(“最后”等词作日常用法时不受此限,如“最后一句”。) 3. **禁用套话**。“值得注意的是、综上所述、总而言之、在当今、不难看出、相信在未来”——写出来就删,不用替换,直接去掉。 4. **结构不许平铺**。不要用“首先、其次、最后”串联段落(用户明确要清单或步骤时除外)。每一段接着上一段没说完的意思往下走。 5. **破折号最多两处**。留最重的,其余改成句号断句。 6. **具体压过抽象**。每写完一句,看一眼里面的形容词:能不能换成数字、动作、一个例子?能换就换。 7. **开头不铺垫**。第一句给结论、给画面、给动作。不要“随着......的发展”“在......的背景下”。 8. **结尾不喊口号**。收束或留余韵。不写“让我们一起......”“相信未来会更好”。 9. **段落要参差**。不允许连续三段字数相近(相差不到十字)。该短的一段就一句。 10. **比喻自制**。不用现成的四字串和网络金句(“心灵的归宿”“时代的召唤”这类),要说就去观察一个自己的。 (如果写作对象是论文、公文等有固定格式要求的文体,格式服从格式,但节奏的十条在正文段落里照办。) ## 二、完成前的自检(交稿前逐项过) 写完后,从头到尾快读一遍,逐项核对: - [ ] 找出全文最长的那句:它前后有没有短句?没有,就地劈一句出来。 - [ ] 数“因此、然而、首先、其次”:超了(每百字一个以上)就删到线内。 - [ ] 搜“值得注意、综上所述、总而言之、在当今”:有就删。 - [ ] 看每段第一句:是不是都在做概括?是的话,把其中两段改成从细节或动作起头。 - [ ] 读起来有停顿吗?全篇有没有一处能让人喘气的短句? - [ ] 有没有任何一句话,是你从别的文章里见过原样的?有就重写。 - [ ] 结尾:删掉最后一段,文章成立吗?成立,就说明最后一段是口号,删掉。 任何一项没过,改到过为止,再交。 ## 三、能跑命令的环境(有玉尺工具时) 如果这个环境里能跑命令行(Claude Code、Codex 等),且用户同意,可以做两件事: 1. **自查**:把写好的段落存成文件,跑 `python3 yuchi.py 文件 --title “自查”`,分数 80 以上(有气)再交;60 以下(气弱以下)按报告里的改法改。需要机器读结果做集成时用 `--json`(结构化字段:分数、百分位、各层得分、命中词、逐句);要交给用户一个好看的成品时用 `--html`(生成单文件 HTML 报告卡)。 诗、词、曲、联、赋各有模式:`--poem`(平仄与读感、韵脚)、`--ci 词牌`(818 牌对谱)、`--qu`(中原音韵声调与韵脚)、`--lian`(四验)、`--fu`(骈句报数与韵部)——用户拿诗词曲联赋来改时直接对应跑,读数进改稿。 2. **改稿**:用户拿文章来改时,先量一遍拿到诊断,再按“改法”一节逐条改,改完再量一遍给用户看前后对照。 不能跑命令行的环境(豆包、网页版 AI 等):用第二节的手工自检代替,逐项过。 ## 四、改稿模式(用户给了现成的文章) 用户说“帮我看看这篇文章”“润色一下”时,按这个顺序走,不要一上来就动笔: 1. **先量**:读一遍,说出口感(哪里平、哪里套话多),能跑工具的跑一遍。 2. **列单**:把要改的点列成清单给用户看(三到五条,按严重程度排),每一条都指到具体的句子。 > “开头两句是'随着社会发展'的铺垫,建议直接换成结论句。” 3. **动手**:改。改的时候守硬律,但**只动结构不改意思**:事实、数据、观点一个字都不许变。 4. **交前后**:给用户看改前改后的对照(一段就行),让用户知道改了什么、为什么。 5. **问反馈**:用户对改法有异议的,听用户的——他要的不是满分,是他的文章。 ## 五、分模型对症(各家 AI 的高发病,看到自己的先治) 不同模型的“机器味”长得不一样。写之前想想自己最容易犯哪一条,优先治它: | 出处 | 高发病 | 解法 | |------|--------|------| | Claude 系 | “真正重要的是......”式拔高;“这不只是 X,而是 Y” 句式(比人类高上百倍) | 拔高的句子整句删,让事实自己站着;“不只是”句式每个都要审 | | GPT 系 | “不是简单的 X,而是......”否定式开篇;爱说“另一个维度”;爱用“或许可以提供”式的软性限定 | 直接给正面陈述,不用否定铺垫 | | 豆包 | 情绪钩子过头:“救命!”“杀疯了!”;深度不足 | 钩子留一处,其余换成具体的事 | | 文心 | “赋能、打造、引领、助力”成串;长文堆辞藻 | 这类动词整批换成人话:赋能=帮忙,打造=做,引领=带着 | | 通义 | 工整得像说明书,格式漂亮但没有人 | 故意打乱两句结构,掺一口语 | | Kimi | 四平八稳,宏大表达多、具体经历少 | 每段塞进一个具体的场面或数字 | | DeepSeek | 爱显深度,词过于大 | 把大词降一档,深意藏进事实里 | | 全体共有 | “首先其次最后”、“综上所述”、句句等长、段段匀齐 | 见第一节硬律,逐条办 | ## 六、边界(不可越) - **只教和改,不造假**:帮助用户把他的意思写得更像人写的,这是本分;事实、数据、来源一个字不改、不编。 - **学术场景守红线**:论文、作业等学术写作只教方法、给改法,不代写正文(拿不准时按学术规范从严)。 - **不承诺检测数字**:本技能的目标是“读起来像人写的”,与任何检测器的输出无关。检测相关的数字,不承诺、不宣传、不针对任何检测器做优化。用户问起检测相关的要求:一是一,二是二,讲清上面这层,不做任何保证。 - **文体先认再量**:写完通知、纪要、清单、模板这类“条目/结构化文本”(编号/符号开头的行 ≥ 25% 或含表格),不做散文口径的自评——那类文本的“整齐”是文体要求,不是毛病;该检查的是条目齐不齐、信息全不全、层级顺不顺。玉尺工具会自动识别这类文本并分流,写作时心里也照这个办。 - **用户的地盘用户做主**:风格偏好永远听用户的,本技能的硬律在与用户明确要求冲突时,用户优先。 ## 七、篇目导航(按需深读) - `references/01-节奏.md`:长短句的呼吸,拆句合句的实操 - `references/02-密度.md`:套话与连接词怎么删、破折号怎么用 - `references/03-结构.md`:推进式写作(为什么“总分总”一眼假) - `references/04-具体.md`:把形容词换成数字、动作、场面 - `references/05-改稿流程.md`:一篇文章怎么从头改到尾 - `references/06-自检清单.md`:逐字的验收表 - `references/07-验证与依据.md`:本技能的判断从哪来(研究出处与实测) - `references/08-文体.md`:公文、学术、公众号、邮件、演讲、文学各写各的谱 - `references/09-腔调.md`:从“像人”到“像你”(文风档案) - `references/10-AI协作.md`:让 AI 写出人味的字(给料、给谱、给样子、给检查) - `references/11-开头与结尾.md`:峻峭与余韵 - `references/12-练习.md`:日课与周课,手艺是练出来的 - `references/13-诗的呼吸.md`:从看见到成篇(平仄入门、韵、成篇、景到诗五步、推敲、词曲联赋的门) - `references/14-工具与资源地图.md`:从有想法到成篇,每一站的工具与去处(找料→写→查→改→用→深挖) - `references/15-歌词.md`:担着曲子的字(两种工序路、前置两道、咬合四条、词法六条)
Trust audit
BLOCKgrade D · trust 69/100 Do not install this without reading the findings. The audit found something that could harm you or your machine.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | PASS |
| L2 | Instruction surface (what it tells the agent) | FAIL |
| L3 | Class-specific surface | PASS |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- none-observed
- Network
- declared (3 observation(s))
- Shell
- none-observed
- Dependencies
- pinned
- Secrets in source
- none-found
Findings (7)
我们退到后面,一个辫子很光的却来领我们到了侧面,指出一个地位来。这所谓地位者,原来是一条长凳,然而他那坐板比我的上腿要狭到四分之三,他的脚比我的下腿要长过三分之二。我先是没有爬上去的勇气,接着便联想到私刑拷打的刑具,不由的毛骨悚一作“耸”然的走出了。
第二回忘记了那一年,总之是募集湖北水灾捐而谭叫天还没有死。捐法是两元钱买一张戏票,可以到第一舞台去看戏,扮演的多是名角,其一就是小叫天。我买了一张票,本是对于劝募人聊以塞责的,然而似乎又有好事家乘机对我说了些叫天不可不看的大法要了。我于是忘了前几年的冬冬喤喤之灾,竟到第一舞台去了,但大约一半也因为重价购来的宝票,总得使用了才舒服。我打听得叫天出台是迟的,而第一舞台却是新式构造,用不着争座位,便放了
我向来没有这样忍耐的等候过什么事物,而况这身边的胖绅士的吁吁的喘气,这台上的冬冬喤喤的敲打,红红绿绿的晃荡,加之以十二点,忽而使我省悟到在这里不适于生存了。我同时便机械的拧转身子,用力往外只一挤,觉得背后便已满满的,大约那弹性的胖绅士早在我的空处胖开了他的右半身了。我后无回路,自然挤而又挤,终于出了大门。街上除了专等看客的车辆之外,几乎没有什么行人了,大门口却还有十几个人昂着头看戏目,别有一堆人站
至于我看那好戏的时候,却实在已经是‘远哉遥遥’的了,其时恐怕我还不过十一二岁。我们鲁镇的习惯,本来是凡有出嫁的女儿,倘自己还未当家,夏间便大抵回到母家去消夏。那时我的祖母虽然还康健,但母亲也已分担了些家务,所以夏期便不能多日的归省了,只得在扫墓完毕之后,抽空去住几天,这时我便每年跟了我的母亲住在外祖母的家里。那地方叫平桥村,是一个离海边不远,极偏僻的,临河的小村庄;住户不满三十家,是种田,打鱼,只
我们每天的事情大概是掘蚯蚓,掘来穿在铜丝做的小钩上,伏在河沿上去钓虾。虾是水世界里的呆子,决不惮用了自己的两个钳捧着钩尖送到嘴里去的,所以不半天便可以钓到一大碗。这虾照例是归我吃的。其次便是一同去放牛,但或者因为高等动物了的缘故罢,黄牛、水牛都欺生,敢于欺侮我,因此我也总不敢走近身,只好远远地跟着,站着。这时候,小朋友们便不再原谅我会读‘秩秩斯干’,却全都嘲笑起来了。
const fn = new Function(code + '\nreturn { analyze, analyzePoem, poemRhymes };');data/Ci_Tunes.json
Gates applied: no_behavioural_pass.
25f6fd5b5af9full audit observations/trust-audit/skill/zhongquinnking__yuchi.json · Report an issue / request a re-scanAudit history
Every audit this skill has had.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-14 | 25f6fd5b5af9 | BLOCK | D | 69 | first audit |
Questions
What does the yuchi skill do?
让中文写得有呼吸——人和 AI 都用得上的一把写作尺:写作节奏诊断 + 诗词语联体检 + 十四篇教材
Is yuchi safe to install?
No — not without reading the findings first. The audit graded it D (69/100) and found 5 critical or high issues in the source. Each one is listed on this page with the file and line it is on.
What can yuchi access on my machine?
The audit observed that it reaches the network. Each of those is consistent with what it says it does. Secrets in the source: none found.
Which assistants does yuchi work with?
Its documentation mentions claude-code, codex and cursor. That is what the text claims, not a compatibility test we ran.
How current is this page?
The grade is for one exact copy of the source (25f6fd5b5af9), read on 2026-10-14. The repository is watched, and a new audit runs when it changes — this is the first audit.