1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | iflytek-text-proofread-iflytek-ifly-skills |
| 项目自述名称 | Ifly Text Proofread（讯飞公文校对；SKILL.md 内部标识符为 iflytek-text-proofread，与正式名称含义一致，不作为名称使用） |
| 作者/维护者 | iFLYTEK（科大讯飞）官方 GitHub 组织 iflytek |
| 来源链接 | https://github.com/iflytek/iFly-Skills/tree/main/skills/iflytek-text-proofread |
| 许可证 | Apache-2.0（GitHub API 确认，适用于整个 iFly-Skills 仓库） |
| GitHub Stars | 217（GitHub API，仓库整体；iFly-Skills 是含 11 个独立技能的合集仓库，此数字不代表本技能自身热度） |
| Forks | 27（GitHub API，仓库整体） |
| 最新版本 | SKILL.md 未标注独立版本号；该技能自 2026-06-17 加入仓库后代码未再变更，仓库整体最近一次提交为 2026-08-11 |
| 安装方式 | git clone 后置入对应 Agent 的 skills 目录，或通过 Skills.sh 等第三方技能市场安装（见第 10 章） |
2. 功能介绍与亮点
Ifly Text Proofread 是 iFLYTEK 官方“公文校对”能力的技能封装，调用讯飞云端 API 对中文文本做全文纠错：
- 27 类错误检测：覆盖三大类——文字标点差错（错别字、多字少字、语序错误、句式杂糅、标点符号、数字量词差错等）、知识性差错（地理名词、机构名称、专有名词、常识差错）、内容导向风险（低俗辱骂、其他敏感内容）
- 超长文本支持：单次请求最长 220,000 字符，超长自动截断并提示，长文档无需手工拆分即可整体校对
- 结果可定位、可回填：每条错误返回位置（position）与长度（length），可直接用于在原文中精确标注或程序化替换
- 零依赖、单条命令：纯 Python 标准库实现（
urllib/hmac/hashlib），无需安装任何第三方包，配置好三个环境变量即可运行 - 输入方式灵活：支持直接传参、标准输入管道、文件读取三种方式，便于接入剪贴板、编辑器插件等外部流程
主要亮点：iFLYTEK 官方出品、完全开源可审计；同一合集内的姊妹技能已有真实第三方开发者提交并被合并的 bug 修复记录，显示该团队对整个技能合集有持续维护投入；本技能自身代码路径简单（单一 HTTP 请求 + 签名认证），截至目前未见任何已提交的缺陷报告。
3. 适用场景
固定分类：内容创作与知识管理
面向需要对中文文本做规范性校对的写作者、编辑与公文起草人员：企事业单位起草公文前的自查、内容团队发布前的错字与敏感词排查、长篇报告或书稿定稿前的通读校对。产出是问题清单与修改建议，不直接覆写原文，方便用户逐条确认后再采纳。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 标准 SKILL.md 格式，仓库明确面向 Claude Code 类 agent 分发 |
| OpenClaw | 原生支持 | SKILL.md 内置 openclaw 元数据块（emoji、维度、用户指令示例），仓库有专门批量添加 openclaw 元数据并配套发布流程的提交记录 |
| Codex | 未验证 | 仓库文档未针对该 harness 做专门说明，本技能是纯 Python 脚本调用，理论上可用但未找到实测记录 |
| Hermes Agent | 未验证 | 同上，未找到相关信息 |
5. 推荐理由
对经常需要产出正式中文文本的用户来说，这个技能用一条命令就能拿到覆盖错别字、语序、敏感内容等 27 类问题的校对结果，不需要额外安装任何依赖包，超长文档也能一次处理完。官方出品、代码路径简单透明、许可证清晰，适合作为公文、报告、书稿定稿前的最后一道校对关卡。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | iFLYTEK 系科大讯飞官方出品；仓库整体 217 star，但属合集仓库、11 个技能共享，不代表本技能个体热度；本技能自身在第三方技能市场暂无独立可查的采用数据 |
| 可用性 | 8 | 纯 Python 标准库实现，无第三方依赖；仅需配置讯飞官方一套 API 凭据即可运行；文档含完整错误码表与 FAQ；截至目前该子技能未见任何已提交的缺陷报告 |
| 安全性 | 8 | 仅执行本地 Python 脚本发起 HTTP 请求，无 shell 执行；数据只发往讯飞官方声明的固定 API 域名（cn-huadong-1.xf-yun.com），无其他外联；API 凭据通过环境变量传入，脚本内不硬编码；SKILL.md 全文未见可疑指令或夹带推广内容；License 为 Apache-2.0，明确；作者为知名企业，无信誉造假迹象 |
| 综合 | 7.67 | 三项均值 |
安全检查清单逐项结果：① 仅执行本地 Python 脚本发起 HTTP 请求，权限范围明确，无越权操作；② 会将用户提交的文本发送至讯飞官方 API 完成校对，数据流向在文档中已注明且目标域名固定透明；③ 要求讯飞 API 凭据（AppID/Key/Secret），通过环境变量存储，为标准做法；④ 全文未发现可疑指令、混淆代码或隐蔽外发逻辑；⑤ 作者为科大讯飞官方组织，无信誉造假迹象；⑥ License 为 Apache-2.0，明确；⑦ 仓库整体近期（5 天内）仍有提交，本技能自身代码自 2026-06-17 起保持稳定、未见需要回溯修复的问题。
7. 跟同类 Skills 相比的优势
| 技能 | 校对对象 | 判定依据 | 语言 | 依赖 |
|---|---|---|---|---|
| Ifly Text Proofread（本技能） | 中文文本（含公文场景），最长 22 万字 | 讯飞公文校对引擎，27 类错误分三大类 | 中文 | 讯飞官方 API 凭据，纯标准库无第三方包 |
| iflytek-contract-intelligence-review（同合集） | 合同类文档（扫描件/拍照/Word/文本） | 六类合同风险 + 双语一致性核对 | 中文/英文/双语 | 需自备 OCR + LLM 服务端点 |
| text-to-speech-elevenlabs-skills | 文本转语音（非校对） | 语音合成质量与音色控制 | 多语言 | ElevenLabs API 凭据 |
Ifly Text Proofread 专注纯文本层面的规范性校对（错别字、语序、敏感内容等），不涉及文档格式转换或内容生成；同合集的 Contract Intelligence Review 面向合同这一垂直场景，需要用户自备 OCR/LLM 后端，配置门槛更高；text-to-speech-elevenlabs-skills 与本技能同属内容创作范畴但功能方向完全不同（语音合成 vs 文本校对），两者互不替代。库内目前没有其他中文文本规范性校对类技能。
8. 用户评价
该技能目前在第三方技能市场尚无具名用户评价或第三方测评文章。所属 iFly-Skills 合集的其他姊妹技能（如语音合成、图像理解模块）在仓库 issue 中有外部开发者提交过真实的 bug 报告并被合并修复，显示该合集整体有真实使用者在跟进维护，但这些反馈并非针对本技能本身。
9. 其他补充
iFly-Skills 是 iFLYTEK 官方合集仓库，除本技能外还包含语音合成、图像理解、OCR、语音转写、视频翻译、声音克隆等 10 个技能，均调用讯飞自有云 API。仓库接受外部贡献并已合并多个真实用户提交的修复 PR。
10. 安装使用方式
方式一：直接克隆子目录
git clone https://github.com/iflytek/iFly-Skills.git
cp -r iFly-Skills/skills/iflytek-text-proofread ~/.claude/skills/方式二：通过第三方技能市场安装（以 Skills.sh 为例）
npx skills add iflytek/ifly-skills/iflytek-text-proofread使用前配置（必需环境变量，在讯飞控制台开通“公文校对”服务后获取）：
export IFLY_APP_ID="your_app_id"
export IFLY_API_KEY="your_api_key"
export IFLY_API_SECRET="your_api_secret"基本用法：
# 校对一段文本
python3 scripts/text_proofread.py "我们要加强对蓝球运动的推广"
# 从文件读取长文档
python3 scripts/text_proofread.py --file report.txt
# 从标准输入管道传入
echo "待校对文本" | python3 scripts/text_proofread.py -安装后无需重启 Agent，下一次对话中提及“校对这段文字”“检查有没有错别字”等意图即可触发。
11. 注意事项
- 使用前需在讯飞控制台自行开通“公文校对”服务并生成 API 凭据，非零配置即用
- 单次请求文本超过 220,000 字符会被自动截断，超大文档建议提前分段
- 校对结果仅为建议，不会自动覆写原文，敏感内容类判定（如“涉低俗辱骂”“其他敏感内容”）的边界标准由讯飞服务端定义，用户对判定结果有异议时应自行复核
- 待校对文本会发送至讯飞官方服务器处理，若涉及机密内容需自行评估是否适合通过云端 API 处理
- 该技能代码自加入仓库以来未见后续变更，但同合集内其他技能有持续的问题修复记录，可作为团队维护活跃度的旁证