STC-Simplified-Technical-Chinese

agent
Guvenlik Denetimi
Basarisiz
Health Uyari
  • License — License: CC-BY-4.0
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Basarisiz
  • spawnSync — Synchronous process spawning in tools/build-skill.mjs
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

STC 简明技术性中文:给 AI 用的中文写作规范 · Simplified Technical Chinese: writing rules, a dictionary, and a CLI that help AI agents write and check Chinese text.

README.md

STC (Simplified Technical Chinese) · 简明技术性中文

中文 | English

介绍视频 · 环境要求 · 快速开始 · 两种用法 · 任务回执 · 更新版本

STC 简明技术性中文是给 AI 用的中文写作规范。项目提供写作规则、词表和 agent 工具。默认表达自然、简短、准确,同一个意思只用一个词。任务回执分清完成结果、用户动作和知会。

名字里的 Simplified 指写法上的简化,不是简体字。

English summary. STC (Simplified Technical Chinese) is a Chinese writing specification for AI. It is for people and for AI agents. It has writing rules, a dictionary, and tools that let agents write and check Chinese text. "Simplified" refers to simplified writing, not to Simplified Chinese characters. STC follows the approach of ASD-STE100 Simplified Technical English. STC is an independent work and contains no text from ASD-STE100. Full English README: README.en.md.

介绍视频

STC 介绍视频封面

在 YouTube 观看

环境要求

  • 单独 skill 的生成、改写和语义审阅由现有 Agent 执行。规则和词表是纯文本,可直接读取。
  • CLI 和随 skill 提供的机器检查需要 Node.js 18 以上版本。安装 CLI 或运行技能安装器需要 npm;直接下载 skill 包可以手动安装。
  • 自动安装和默认配置需要 Agent 能写入选定目录。机器检查没有第三方运行时依赖,安装后可离线运行。

快速开始

同一个仓库提供两条安装路径。CLI 适合需要终端检查和 CI 的用户;skill 适合让 Agent 直接生成、改写和审阅中文。

npm 安装 CLI

npm install -g @daimonia/stc@latest
stc init

init 安装 skill 和按需入口。确认默认使用后,运行 stc init --defaults。检查文件用 stc check <文件>。也可以用 npx --yes @daimonia/stc@latest init 临时运行。

给 Agent 粘贴的安装指令:

请在当前项目安装 STC:https://github.com/daimonia-ai/STC-Simplified-Technical-Chinese。使用 npm 安装 @daimonia/stc@latest,再运行 stc init。装好后读取 ONBOARDING.md,建议设为默认中文输出规则,等我确认;也可以由我指定材料体验一次审阅。

单独安装 skill

使用技能安装器,按提示选择 Agent 和项目范围:

npx skills add daimonia-ai/STC-Simplified-Technical-Chinese --skill stc

可用 --agent codex、--agent claude-code 或 --agent hermes-agent 指定入口,--global 安装到个人技能目录。技能安装器文档说明其他选项。

也可以从 GitHub Releases 下载 stc-skill-0.2.1.zip,将包里的 stc/ 放到 Agent 的技能目录。

给 Agent 粘贴的安装指令:

请单独安装 STC skill:https://github.com/daimonia-ai/STC-Simplified-Technical-Chinese。为当前 Agent 选择合适的技能目录。装好后读取 ONBOARDING.md,建议设为默认中文输出规则,等我确认;审阅材料由我指定或授权挑选。

skill 包含规则、词表、引导与检查脚本。只装 skill 时,Agent 已能使用内置的自然、简短表达原则。运行机器检查可用 node <skill目录>/tools/cli.mjs check <文件>。

默认表达

每次使用 STC,都会同时执行这套表达原则:

  • 用自然语序和完整句子,直接给出答案或结果。
  • 删除客套、重复、空话和读者不需要的解释。
  • 保留事实、数字、名称、否定词、权限和真实不确定性。
  • 按任务需要展开,完整文稿和详细解释必须满足请求。
  • 成品从采用的结果写起,制作和复核记录放在内部。

自然表达和精简方法已内置于 skill 与默认配置。具体规则见 G14、G15、G20、G21、G22 和场景规则。

任务回执

使用 STC 汇报任务结果时,默认按三段组织:

段落 内容
做完了 已完成的结果、交付物和必要的验证结论
需要你 用户要执行的动作或决定的事项
知会 不需要用户动作、但影响理解或后续使用的信息

空段写“无”。详细分析放在文档中,回执给出摘要和入口。普通问答、成品正文和用户指定的其他格式按各自要求处理。具体规则见 C10。

可以直接对 Agent 说:

完成这个任务后,按 STC 给我任务回执。分清已经做完的结果、需要我处理的事和只需知晓的信息。

两种用法

可以只用一种,也可以两种一起用。一起用时,默认输出规则让 agent 一开始就按 STC 写,审阅时再找出漏掉的问题。

用法一:设成 agent 的默认输出规则

把这段话直接贴给 agent:

请在当前项目安装或更新 STC 简明技术性中文:https://github.com/daimonia-ai/STC-Simplified-Technical-Chinese,并设为默认中文输出规则,让表达自然、简短、准确。保留其他项目配置,完成后说明生效范围。

这段指令已授权设置默认规则。生效后可以直接提出写作任务,例如:

请根据以下要点写一份项目进展说明:【粘贴要点】

手动配置时,按以下步骤操作:

在项目里运行 stc init,装好 skill、规则和词表。首次安装登记按需使用入口。

用户确认后,运行 stc init --defaults,将核心规则写入项目上下文。之后 agent 写中文时,先判断场景,再读取规则。

安装后的引导见 Onboarding for Agents。已启用默认规则的项目再次运行 init 时,会保留该状态。

单独安装 skill 时,按 ONBOARDING.md 用实际安装路径启用默认规则。只有安装授权时,先等待用户选择;上面的默认使用指令已经包含启用授权。

用法二:让 agent 审阅并优化已有内容

安装后,把这段话和待处理文字一起贴给 agent:

请按 STC 审阅并优化以下中文,保留事实、数字、名称和原意,给出改写稿并简要说明主要改动:【粘贴文字】

审阅项目文件时,可以这样说:

请按 STC 审阅【文件路径】,列出主要问题和具体改法,保留源文件。

需要 agent 挑选首次体验的材料时,可以直接授权:

请从当前项目挑选一份中文文档,说明选择理由,再按 STC 做一次只读审阅并给出具体改法。

此用法可按需调用,无须启用默认输出规则。

对 agent 说“按 STC 审一下这份文档”。agent 会用 STC 的 skill 审阅用户指定或授权挑选的材料,给出问题、原因和改法。用户要求修改时,agent 再按授权修改。人也可以自己运行 stc check <文件或目录>。这条命令找出机器能判断的问题,每条问题带规则编号。发现错误时返回退出码 1,可以放进 CI。

机器判断不了的规则(比如事实有没有出处),由 agent 按 skill 审查,或由人审稿。不装任何东西也可以直接读 rules/ 和 dictionary/,用来审稿、培训或自己写工具。

Anti-Echo 交付检查

Anti-Echo 要求每句话服务当前读者,覆盖多余排除、制作说明和结尾自证。必要的价格范围、权限限制和安全提示必须保留。

stc check 文档.md --profile for-document --anti-echo

命令发现未复核的 G20 疑点时返回 1。Agent 必须改写,或结合上下文记录具体保留理由;语义复核还须检查规则未匹配到的内容。复核文件与 CI 用法。

Codex 和 Claude Code 可按需配置 Stop hook,对回复中的疑点发起一次补审。

更新版本

按安装方式更新。

CLI 安装

先更新 npm 命令行包,再刷新项目里的 skill 和规则。

把这段话贴给 agent:

请把 STC 的 npm 命令行工具更新到最新版,并刷新当前项目实际引用的 STC skill 和规则,保留已启用的默认规则、其他项目配置和项目术语,最后核对两处版本。

手动更新时,在已安装 STC 的项目根目录运行:

npm install -g @daimonia/stc@latest
stc --version
stc init
node .claude/skills/stc/tools/cli.mjs --version

npm install 更新本机 CLI。stc init 将新版文件复制到当前项目,并保留已有的默认设置。两条版本命令的结果须一致。

  • 每个已安装 STC 的项目都需要运行一次 stc init。
  • 安装时用了 --dir,更新时须使用相同目录。第二条版本命令也须改为该目录。
  • --dir 只改变 skill 的位置;项目配置仍写在当前目录。

临时运行最新版并刷新当前项目,也可以用:

npx --yes @daimonia/stc@latest init

单独 skill 安装

用技能安装器安装的项目 skill,在项目根目录运行:

npx skills update stc

全局 skill 使用 npx skills update stc --global。下载包装的 skill,下载新包后替换原技能目录。更新时保留项目术语和现有默认配置。

给 Agent 粘贴的更新指令:

请按原来的安装方式更新 STC skill,核对实际技能目录和版本,保留已有默认规则、项目术语及其他配置。使用新的 ONBOARDING.md 核对启用状态。

skill 的检查脚本可用 node <skill目录>/tools/cli.mjs --version 核对版本。技能与 npm 从同一份源文件发布。

为什么做

大模型写中文,常见的问题是写得多、写法散。同一个东西换着叫法,程度词代替数字。“进行优化”“赋能”“闭环”这类词把句子撑长,代词也指代不清。还常加读者不需要的说明,比如“西红柿炒鸡蛋(没有东坡肉)”。读的人要花时间猜,agent 之间传话也会走样。

英文有 ASD-STE100:53 条写作规则,加一本约 900 个许可词的词典,每个词只有一个意思、一个词性。ASD-STE100 在 1986 年首次发布,用于航空维修手册,现行版本是 2025 年发布的第 9 版。中文输出也需要这样的表达规范。

STC 给中文补上这一套,从一开始就按 AI agent 能直接使用来设计。

对谁有用

日常使用 AI 聊天、写文档的人可以用 STC。回复少些废话,文档把意思讲清楚。

也可用于这些专业工作:

  • 开发 AI 产品、编写 agent 的团队:系统提示词、规则文件、agent 的输出
  • 写产品界面文字的人:按钮、提示、报错、说明
  • 写技术文档、报告的人
  • 需要一份中文写作标准、并且要求机器能检查的团队

组成

组成 内容 位置
规则 通用规则,加四个场景各自的规则 rules/
词表 推荐词(一个词一个意思)、不推荐写法(附推荐写法)、项目术语表模板 dictionary/
核心规则片段 贴进 AGENTS.md 或 CLAUDE.md 的十来行规则 snippets/agents-md.md
skill agent 写、改、审中文时加载的技能包 SKILL.md
命令行工具 stc init 把 STC 装进项目,stc check 找出机器能判断的问题 tools/

四个场景

写之前先判断在写哪类文字,再用“通用规则 + 对应场景的规则”。

场景 写的是什么 和其他场景的主要区别
for chat agent 在对话里回复人 可以用“我”“你”;第一句回答问题
for document 给人读的文字:报告、方案、手册、代码注释、提交说明 主语写名称,不写“我们”“你们”
for web dev 网页和应用界面上给用户看的文字 不用复数人称和第三人称代词;按钮以动词开头
for instruction writing 写给 agent 执行的规则:系统提示词、AGENTS.md、skill 要求的强度只用“必须、不得、宜、不宜、可、不必、能、不能”

仓库结构

ONBOARDING.md   安装后建议默认使用,提供一次文档审阅体验
SKILL.md        skill 入口:判断场景,读规则和词表,写、改写、审查
rules/          规则:通用规则与四个场景
dictionary/     词表:推荐词、不推荐写法、项目术语表模板
snippets/       贴进 AGENTS.md / CLAUDE.md 的核心规则
tools/          命令行工具 stc:init 安装,check 检查
evals/          skill 的测试任务

词表怎么定

词条按真实的 AI 中文输出中的出现次数排定先后。例句使用通用名称,不含可识别的个人或企业信息。

和 ASD-STE100 的关系

STC 参考 ASD-STE100 的结构:写作规则、词义明确的词表、允许项目自建术语表。规则和词条由 STC 独立编写,不翻译、不摘抄 ASD-STE100 的正文、规则原文或词典条目。针对大模型输出中文的常见问题,STC 补充了表达规则和词表。例如 G20 要求删掉读者不需要的排除说明。

ASD-STE100 的版权归 ASD(Aerospace, Security and Defence Industries Association of Europe)所有,“ASD-STE100 Simplified Technical English”是 ASD 的欧盟注册商标。STC 不是 ASD-STE100 的官方中文版本,本仓库不分发 ASD-STE100 的文本。需要原文请到官网免费申请:https://www.asd-ste100.org/

英文写作可以直接使用 ASD-STE100。

其他参考

  • GB/T 1.1—2020《标准化工作导则 第 1 部分:标准化文件的结构和起草规则》:条款的助动词
  • GB/T 15834—2011《标点符号用法》
  • GB/T 15835—2011《出版物上数字用法》

同类项目

STC 和这两个项目的差别:STC 以词表为核心,并按 for chat、for document、for web dev、for instruction writing 四个场景分别给出规则。

许可

  • 规则与词表:CC BY 4.0,可以复制、修改、商用,必须注明出处
  • 代码(命令行工具、skill、配置示例):MIT

维护

由 代梦智能(Daimonia) 发起并维护。STC 是开源项目,欢迎一起共建:提交词条、规则和 issue 都可以。

Yorumlar (0)

Sonuc bulunamadi