Install
openclaw skills install @huiyonghkw/hekouwang-writer-skill会勇禾口王的中文写作技能,两种模式。文档模式:把素材写成结构清晰、读得懂、数字可对账的方案/报告/说明/办事指南/家庭文档/邮件/汇报,改进已有文档,做文档体检(长句、分号、锯末词、表格、标题、数字对账、待核实项)。文章模式:公众号文章、长文章母版、文案的去AI味与人性化改写,先诊断再改写,保留事实、原意和信息密度。会勇禾口王内容工作流里中文文章母版定稿前默认使用。触发词:写文档、改文档、文档润色、文档体检、核对文档、汇报材料、去AI味、人性化、润色文章、润色文案、/deai。不用于从零新写营销文案、诗歌、小说。
openclaw skills install @huiyonghkw/hekouwang-writer-skill一句话定位:先想清楚写给谁、用来做什么,再用纪律把内容装进结构。产出三样东西——结构(文档骨架)、质量(可核对的文案)、证据(可追溯的出处)。
两种模式:文档模式(默认,第二到四节)和文章模式(1.3 节)。三大铁律两种模式都生效。
下文 <skill> 指本 SKILL.md 所在目录(不是用户的工作目录)。
| 铁律 | 内容 | 反面教材 |
|---|---|---|
| 出处铁律 | 政策、数字、专有名词必须有出处;查不到就标注"暂无出处,建议核实",不编造 | "应该是……""一般来说……" |
| 模态铁律 | "可能/约/待核实/以窗口核定为准"是内容,不是噪音;简化时原样保留 | 把"可能失败"简化成"失败" |
| 修订铁律 | 改文档只调表达与结构,保留事实与意图;每处改动列出,可回退 | 悄悄重写用户的事实 |
违反任一铁律的交付,一律打回。
时效事实(现行政策、标准金额、办理渠道、最新数据)不能只靠记忆或转述:定向联网核实一次,找到能打开的官方原始来源就停;缺口最多补搜一次,仍查不到就标"暂无出处,建议核实"。依据表写访问日期,链接必须是实际打开过的页面。→ 细则读 references/evidence-and-delivery.md 第一b节。
| 档位 | 特征 | 必跑脚本 | 必过步骤 | 可免 |
|---|---|---|---|---|
| 轻量 | 改一段/一句话/一个小表 | 无(改完自查) | 改动说明 | WRITE 全流程、进度卡 |
| 常规 | 一篇文档的写作或改进 | sawdust + sentence_load + doc_lint | WRITE 五步、出口闸门两问、交付格式 | 大纲预确认 |
| 复杂 | 多文档/多来源冲突/重大决策文档 | 四把全跑(加 check_fidelity) | 大纲预确认、WRITE 五步、出口闸门、关键数字双源核对、进度卡 | 无 |
判不准时按"常规"执行,并在交付时说明假设。用户说"随便改改"而实际动了结构 → 升一档。
真实稿 / 试写稿:用户给了真实材料、具体事项或要实际发出去 → 真实稿,出处铁律全程生效,不补写任何事实。用户明确要示例/模板/"写个样子看看",且没给真实材料 → 试写稿,可用 【待填:XX】 占位,文首标"示例稿,事实未核实",不编造看似真实的数字和文号。判定后整轮不再切换。
不要默认当新写。
change_list.py 改前 改后。改前稿在 git 里用 git show HEAD:文件 取,否则动笔前先复制到系统临时目录。脚本列出而改动清单里没有的,是未申报改动,补进清单或还原。"数字变动"告警必须逐条说明理由。对象是文章或文案、用户要"去 AI 味/人性化/润色文章"、或调用 /deai 时进入。先诊断再改写,保留事实、原意和信息密度。
sawdust_scan.py。先给用户看,不直接改。文档模式里不补第一人称。Humanizer-zh 只在需要通用规则时备用,不同时加载。
→ 六类诊断的认法、改写示例、输出格式:读 references/article-mode.md。
references/clarify-questions.md 问,最多 3 个;能合理默认就默认。用户给了"要求+素材"时跳过,直接动笔。→ 五步操作卡、七种文档原型结构、单一真源与摘要写法、30 秒导航表(可选,何时加)、措辞四原则、进度卡模板:读 references/write-flow.md。
references/glossary.md。→ 完整规则表、模态保护、放行判定流程、同义词轮换的合法情况:读 references/style-rules.md。
| 轴心 | 问自己 |
|---|---|
| 保真 | 数字、日期、金额、文件名对吗?能对账吗? |
| 去AI味 | 锯末词扫了吗?收束句硬加了吗? |
| 一致 | 术语、口径、单位全文统一吗? |
| 可读 | 结论前置了吗?只读摘要能知道要做什么吗?长句拆了吗? |
| 场景适配 | 结构与读者匹配吗(给家属的不该满纸条款)? |
references/evidence-and-delivery.md 第一c节):
→ 证据三分、交付格式、诚实状态标签、降级示例:读 references/evidence-and-delivery.md。
sawdust_scan.py 查锯末词,密度上限 3 处/千字;政策专有名词、引用原文是例外。→ 锯末词全表、G1-G5 场景例、交付前自检清单:读 references/deai-flavor.md。
<skill>/.learnings/(LEARNINGS.md / ERRORS.md / FEATURE_REQUESTS.md),不写进用户项目。CHANGELOG.md 记一笔。→ 条目格式模板:读 references/evidence-and-delivery.md 第五节。
<skill>/scripts/,只报告不修改,全部 stdlib,全部带 --selftest)| 脚本 | 查什么 | 何时跑 |
|---|---|---|
sawdust_scan.py | 锯末词密度(阈值 3 处/千字) | 每篇必跑 |
sentence_load.py | 句长/分句堆叠/修饰嵌套/分号 | 每篇必跑 |
doc_lint.py | 表格列数一致性(硬错误)、标题层级跳跃、分号密度、同义词轮换(文档里声明过的简称不报)、完整身份证号/手机号、待核实项清点 | 每篇必跑;有硬错误时退出码 1 |
check_fidelity.py | 算术对账:表格合计行/列、乘法 A×B=C、加法等式链 | 复杂档必跑;常规档动过数字时跑;不一致退出码 1 |
change_list.py | 改前/改后两稿的全部改动处 + 数字变动告警 | 修订模式常规档以上;用来和手写改动清单对账;--strict-numbers 时数字变动退出码 1 |
用法:python3 <skill>/scripts/<脚本>.py <文档.md>(change_list.py 传两个文件:改前 改后),或 echo "文本" | python3 <skill>/scripts/<脚本>.py。
改动脚本前先跑 --selftest。接入 git hook / CI 的写法见 README.md。
需要看方法落地的完整样例时,读 examples/family-pension-case.md。
Will:结构化改造、句法纪律、证据标注、体检报告、改动清单、术语表。 Will not:从零新写创意/营销文案、诗歌、小说;替作者编第一人称经历;替用户做事实判断(只标注不确定);无出处编造;把"约/可能"删成确定表述;保证 100% 合规(放行项必须人工判断并注明理由)。
适用范围:中文文档与中文文章。句长阈值按中文字符设计,英文不适用。
协作分工(这些情况交给别的 skill,本 skill 只做文档本身):
| 情况 | 交给 |
|---|---|
| 文档里大量公开事实、新闻、统计需要逐条核查 | 事实核查类 skill(如腾讯较真 jiaozhen-factcheck、Claim Verifier);结论按证据三分回填依据表 |
| 正式公文(请示/通知/函,GB/T 9704 版式) | 公文类 skill(如 chinese-official-writing) |
| 要直接写进在线文档 | 腾讯文档 / 金山文档 skill;先在本 skill 定稿再写入 |
未安装对应 skill 时,本 skill 按自身规则降级完成,并在交付时说明哪一步没有专门工具。