fix: 完善开源文档与 npm 发布流程

.agents/skills/chinese-article-writing/SKILL.md

@@ -0,0 +1,88 @@
+---
+name: chinese-article-writing
+description: Create, rewrite, polish, and proofread Chinese articles, technical blogs, documentation, and technical talks. Use when the user asks for Chinese writing help, Chinese technical article structure, tone consistency, proofreading, terminology consistency, punctuation, spacing, formatting, or fixing awkward Chinese prose.
+---
+
+# 中文文章书写助手
+
+本技能用于指导中文文章的书写，解决“不知道如何写、只能凭感觉写”的问题。
+内容分为写作语气、写作流程和写作规范。请根据任务按需读取参考文件，不要默认加载全部 references。
+
+## 适用场景
+
+当用户需要以下任务时，使用本技能：
+
+- 编写中文技术文章、博客或技术分享
+- 规范或润色已有中文文档
+- 统一文章风格与结构
+- 提高文章的专业性与可读性
+- **修复文章中的语气不一致问题**
+- **修正错别字、病句、用词不当**
+- **统一英文大小写、术语与格式**
+
+## 使用流程
+
+根据用户需求，选择以下执行方式：
+
+### 生成或重写模式
+
+1. 明确文章类型与目标读者
+2. 判断是否需要读取语气示例
+3. 按任务类型读取对应写作规范
+4. 生成完整文章或重写指定内容
+
+### 修复与校对模式
+
+1. 通读用户提供的全文或指定段落
+2. 统一整体语气，避免前后风格不一致
+3. 修复以下常见问题：
+   - 错别字与明显病句
+   - 英文与缩写的大小写不一致
+   - 技术术语前后不统一
+   - 口语化、模糊或不精确表达
+4. 在不改变原意的前提下提升清晰度与专业度
+
+## 参考文件选择
+
+按任务选择参考文件，不要为了普通润色或短文本修复加载全部文件：
+
+- 标题、层级、目录命名：读取 [标题规范](./references/title.md)
+- 句子、字间距、英文处理、表达风格：读取 [文本规范](./references/text.md)
+- 段落组织、引用、段落长度：读取 [段落规范](./references/paragraph.md)
+- 数字、百分比、货币、范围表达：读取 [数值规范](./references/number.md)
+- 标点、引号、括号、破折号、省略号：读取 [标点符号规范](./references/marks.md)
+- 技术文档、手册、知识库结构：读取 [文档体系规范](./references/structure.md)
+- 长文写作、技术分享、需要模仿语气时：读取 [语气示例](./references/sample-article.md)
+
+`sample-article.md` 只用于参考表达节奏、段落组织和技术叙述语气，不要复用其中的主题、观点或具体内容。
+
+## 中文写作规范
+
+中文技术文档应优先保证清晰、准确、克制和一致。修改文章时，先保持原意，再优化结构和表达。
+
+## 常见写作问题修复规范
+
+在修复与校对模式下，请遵循以下原则：
+
+### 语气
+
+- 保持全文语气一致（技术理性 / 分享叙述 / 教学说明）
+- 避免同一篇文章中混用口语与正式书面语
+- 避免情绪化或夸张表达（除非是分享类文章）
+
+### 错别字与病句
+
+- 修正明显错别字
+- 调整语序不通顺的句子
+- 删除重复或冗余表达
+
+### 大小写与格式
+
+- 英文缩写统一大小写（如 API、HTTP、i18n）
+- 中英文之间保留适当空格
+- 数字与单位格式保持一致
+
+### 术语一致性
+
+- 同一概念只使用一种表述
+- 首次出现时可给出全称，后续使用简称

.agents/skills/chinese-article-writing/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Chinese Article Writing"
+  short_description: "Polish Chinese technical writing"
+  default_prompt: "Use $chinese-article-writing to polish this Chinese technical article for clarity, tone, and formatting."

.agents/skills/chinese-article-writing/references/marks.md

@@ -0,0 +1,165 @@
+# 标点符号
+
+## 原则
+
+（1）中文语句的标点符号，均应该采取全角符号，这样可以与全角文字保持视觉的一致。
+
+（2）如果整句为英文，则该句使用英文/半角标点。
+
+（3）句号、问号、叹号、逗号、顿号、分号和冒号不得出现在一行之首。
+
+（4）点号（句号、逗号、顿号、分号、冒号）不得出现在标题的末尾，而标号（引号、括号、破折号、省略号、书名号、着重号、间隔号、叹号、问号）可以。
+
+## 句号
+
+（1）中文语句的结尾处应该用全角句号（`。`）。
+
+（2）句子末尾用括号加注时，句号应在括号之外。
+
+```
+错误：关于文件的输出，请参照第 1.3 节（见第 26 页。）
+
+正确：关于文件的输出，请参照第 1.3 节（见第 26 页）。
+```
+
+## 逗号
+
+（1）逗号（`，`）表示句子内部的一般性停顿。
+
+（2）注意避免“一逗到底”，即整个段落除了结尾，全部停顿都使用逗号。
+
+## 顿号
+
+（1）句子内部的并列词，应该用全角顿号(`、`) 分隔，而不用逗号，即使并列词是英语也是如此。
+
+```
+错误：我最欣赏的科技公司有 Google, Facebook, 腾讯, 阿里和百度等。
+
+正确：我最欣赏的科技公司有 Google、Facebook、腾讯、阿里和百度等。
+```
+
+（2）英文句子中，并列词语之间使用半角逗号（`,`）分隔。
+
+```
+例句：Microsoft Office includes Word, Excel, PowerPoint, Outlook and other components.
+```
+
+（3）中文句子内部的并列词，最后一个尽量使用（`和`）来连接，使句子读起来更加连贯，下面两个句子都可以，第二个更优。
+
+```
+正确：我最欣赏的科技公司有 Google、Facebook、腾讯、阿里，以及百度等。
+
+正确：我最欣赏的科技公司有 Google、Facebook、腾讯、阿里和百度等。
+```
+
+## 分号
+
+（1）分号（`；`）表示复句内部并列分句之间的停顿。
+
+## 引号
+
+（1）引用时，应该使用全角双引号（`“ ”`），注意前后双引号不同。
+
+```
+例句：许多人都认为客户服务的核心是“友好”和“专业”。
+```
+
+（2）引号里面还要用引号时，外面一层用双引号，里面一层用单引号（`‘ ’`），注意前后单引号不同。
+
+```
+例句：鲍勃解释道：“我要放音乐，可萨利说，‘不行！’。”
+```
+
+## 括号
+
+（1）补充说明时，使用全角圆括号（`（）`），括号前后不加空格。
+
+```
+例句：请确认所有的连接（电缆和接插件）均安装牢固。
+```
+
+（2）几种括号的中英文名称。
+
+|       |            英文             |  中文  |
+| ----- | :-------------------------: | :----: |
+| `{ }` |  braces 或 curly brackets   | 大括号 |
+| `[ ]` | square brackets 或 brackets | 方括号 |
+| `< >` |       angled brackets       | 尖括号 |
+| `( )` |         parentheses         | 圆括号 |
+
+## 冒号
+
+（1）全角冒号（`：`）常用在需要解释的词语后边，引出解释和说明。
+
+```
+例句：请确认以下几项内容：时间、地点、活动名称和来宾数量。
+```
+
+（2）表示时间时，应使用半角冒号（`:`）。
+
+```
+例句：早上 8:00
+```
+
+## 省略号
+
+（1）省略号（`⋯⋯`）表示语句未完、或者语气的不连续。
+
+（2）省略号占两个汉字空间、包含六个省略点，不要使用`。。。`或`...`等非标准形式。
+
+（3）省略号不应与“等”这个词一起使用。
+
+```
+错误：我们为会餐准备了香蕉、苹果、梨…等各色水果。
+
+正确：我们为会餐准备了各色水果，有香蕉、苹果、梨⋯⋯
+
+正确：我们为会餐准备了香蕉、苹果、梨等各色水果。
+```
+
+## 感叹号
+
+（1）应该使用平静的语气叙述，尽量避免使用感叹号（`！`）。
+
+（2）不得多个感叹号连用，比如`！！`和`!!!`。
+
+## 破折号
+
+（1）破折号`————`一般用于进一步解释。
+
+（2）破折号应占两个汉字的位置。如果破折号本身只占一个汉字的位置，那么前后应该留出一个半角空格。
+
+```
+例句：直觉————尽管它并不总是可靠的————告诉我，这事可能出了些问题。
+
+例句：直觉 —— 尽管它并不总是可靠的 —— 告诉我，这事可能出了些问题。
+```
+
+## 连接号
+
+（1）连接号用于连接两个类似的词。
+
+（2）以下场合应该使用直线连接号（`-`），占一个半角字符的位置。
+
+- 两个名词的复合
+- 图表编号
+
+```
+例句：氧化-还原反应
+
+例句：图 1-1
+```
+
+（3）数值范围（例如日期、时间或数字）应该使用波浪连接号（`～`）或一字号（`—`），占一个全角字符的位置。
+
+```
+例句：2009 年～2011 年
+```
+
+注意，波浪连接号前后两个值都建议加上单位。
+
+（4）波浪连接号也可以用汉字“至”代替。
+
+```
+例句：周围温度：-20 °C 至 -10 °C
+```

.agents/skills/chinese-article-writing/references/number.md

@@ -0,0 +1,68 @@
+# 数值
+
+## 半角数字
+
+阿拉伯数字一律使用半角形式，不得使用全角形式。
+
+```
+错误：这件商品的价格是１０００元。
+
+正确：这件商品的价格是 1000 元。
+```
+
+## 千分号
+
+数值为千位以上，应添加千分号（半角逗号）。
+
+```
+XXX 公司的实收资本为 ￥1,258,000 人民币。
+```
+
+对于 4 位的数值，千分号是选用的，比如`1000`和`1,000`都可以接受。对于 4 位以上的数值，应添加千分号。
+
+## 货币
+
+货币应为阿拉伯数字，并在数字前写出货币符号，或在数字后写出货币中文名称。
+
+```
+$1,000
+1,000 美元
+```
+
+英文的货币名称，建议参考国际标准 [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217)。
+
+## 数值范围
+
+表示数值范围时，用波浪线（`～`）或一字线（`—`）连接。参见《标点符号》一节的“连接号”部分。
+
+带有单位或百分号时，两个数字建议都要加上单位或百分号。
+
+```
+132 kg～234 kg
+
+67%～89%
+```
+
+## 变化程度的表示法
+
+数字的增加要使用“增加了”、“增加到”。“了”表示增量，“到”表示定量。
+
+```
+增加到过去的两倍
+（过去为一，现在为二）
+
+增加了两倍
+（过去为一，现在为三）
+```
+
+数字的减少要使用“降低了”、“降低到”。“了”表示增量，“到”表示定量。
+
+```
+降低到百分之八十
+（定额是一百，现在是八十）
+
+降低了百分之八十
+（原来是一百，现在是二十）
+```
+
+不能用“降低 N 倍”或“减少 N 倍”的表示法，要用“降低百分之几”或“减少百分之几”。因为减少（或降低）一倍表示数值原来为一百，现在等于零。

.agents/skills/chinese-article-writing/references/paragraph.md

@@ -0,0 +1,30 @@
+# 段落
+
+## 原则
+
+- 一个段落只能有一个主题，或一个中心句子。
+- 段落的中心句子放在段首，对全段内容进行概述。后面陈述的句子为中心句子服务。
+- 一个段落的长度不能超过七行，最佳段落长度小于等于四行。
+- 段落的句子语气要使用陈述和肯定语气，避免使用感叹语气。
+- 段落之间使用一个空行隔开。
+- 段落开头不要留出空白字符。
+
+## 引用
+
+引用第三方内容时，应注明出处。
+
+```
+One man’s constant is another man’s variable. — Alan Perlis
+```
+
+如果是全篇转载，请在全文开头显著位置注明作者和出处，并链接至原文。
+
+```
+本文转载自 WikiQuote
+```
+
+使用外部图片时，必须在图片下方或文末标明来源。
+
+```
+本文部分图片来自 Wikipedia
+```