PHP安全过滤库输入过滤最佳实例探究
2026/9/26 21:36:03
3分钟装好SimpleEnglish，让Claude/Codex告别AI味写文档：4种安装方式完整指南
【免费下载链接】SimpleEnglishAgent skill: make LLMs write docs in ASD-STE100 Simplified Technical项目地址: https://gitcode.com/gh_mirrors/si/SimpleEnglish
SimpleEnglish 是一个开源 Agent 技能，把航空界使用 40 年的 ASD-STE100 简化技术英语规则装进 Claude、Codex 等 AI 工具，让它们写出的 README、Runbook、错误提示告别"AI 味"。无需写代码、无依赖，一行命令即可完成 SimpleEnglish 安装，本文给出 4 种安装方式的完整步骤。
⏱ 安装前 30 秒准备
| 项目 | 要求 |
|---|---|
| Node.js | 仅插件钩子需要（src/hooks/README.md） |
| 网络 | 可访问包管理器即可 |
| 支持的 Agent | Claude Code、Cursor、VS Code Copilot、OpenAI Codex、Gemini CLI、OpenCode 等约 30 款 |
核心规则本体是 skills/simple-english/SKILL.md，包含 53 条编号规则，按 9 个章节组织，全部基于 ASD-STE100 Issue 9（2025-01-15）编写。
📦 4 种 SimpleEnglish 安装方式对照
| 方式 | 适用场景 | 一行命令搞定 |
|---|---|---|
| ① skills CLI | 任意支持 Agent Skills 标准的工具 | 是 |
| ② Claude Code 插件 | 想要技能 + 会话钩子 + 输出风格 | 是 |
| ③ Codex 插件 | OpenAI Codex 用户 | 是 |
| ④ 手动粘贴提示词 | claude.ai、ChatGPT、Gemini 网页版 | 复制粘贴 |
方式一：skills CLI 一行安装（推荐所有 Agent）
任何读取 Agent Skills 标准的工具都能用 skills CLI 安装：
npx skills add AminBlg/SimpleEnglish不想安装也可以先试用：
npx skills use AminBlg/SimpleEnglish@simple-english方式二：Claude Code 插件安装步骤
插件包含技能、会话钩子和输出风格三部分：
claude plugin marketplace add AminBlg/SimpleEnglish && claude plugin install simple-english@simple-english安装后，会话钩子会在启动时自动载入写法规则（实现见 src/hooks/simple-english-activate.js），你不需要每次点名技能。
再启用配套的输出风格simple-english:simple-english（定义在 output-styles/simple-english.md）：
- 单个项目：运行
/config，打开 Output style，选中它 - 全部项目：在
~/.claude/settings.json写入{"outputStyle": "simple-english:simple-english"}，然后重启 Claude Code
⚠️ 注意使用完整名称，短名无法解析。
方式三：Codex 插件安装与钩子信任
codex plugin marketplace add AminBlg/SimpleEnglish codex plugin add simple-english@simple-english首次运行前，Codex 会要求你信任/hooks中的会话钩子，按提示批准即可。钩子配置在 hooks/hooks.json，它匹配startup|resume|clear|compact四种会话启动场景。
方式四：手动粘贴系统提示词（无技能支持时）
网页版 ChatGPT、Gemini 或任何不支持 SKILL.md 的环境，直接复制 prompts/system-prompt.md 的内容：
- 粘进系统提示词、
AGENTS.md或.cursorrules - 在 claude.ai、ChatGPT、Gemini 上作为第一条消息发送
- 该文件末尾还附了约 60 token 的极简版，适合上下文预算紧张的场景
也可以手动克隆仓库后自行部署 skills/simple-english/ 目录：
git clone https://gitcode.com/gh_mirrors/si/SimpleEnglish✅ 装好之后怎么用
不需要任何特殊语法。直接提出技术写作需求，或者说一句：
rewrite this with simple-english
典型改写效果（摘自 examples/before-after.md）：
| 装前（真实 AI 输出） | 装后（技能生效） |
|---|---|
| Leverage sqlpipe's robust architecture, users can seamlessly synchronize… | sqlpipe copies your Postgres tables to S3. It needs one configuration file. |
| "It is worth noting that the migration has been completed…" | "The migration completed. The database rebuilds the table." |
长句被拆到 20 词以内、被动语态变主动、模糊措辞全部删除——而代码、命令、报错字符串一字不动（"Untouchables" 规则，见 SKILL.md）。
📊 效果如何：数据说话
在 7 个 Claude 模型 × 8 类写作任务（112 次生成）的基准测试中，技能开启后STE 违规率平均下降 74.6%；盲测评委在 56 组对比中 45 次选择了技能输出（详见 evals/results/RESULTS.md）。
| 模型 | 基线违规/百词 | 技能违规/百词 | 降幅 |
|---|---|---|---|
| claude-opus-5 | 2.13 | 0.32 | 85% |
| claude-opus-4-7 | 2.28 | 0.42 | 82% |
| claude-sonnet-5 | 2.67 | 0.53 | 80% |
同样的 8 类任务在 Pi、OpenAI API 等其他运行环境上也复现了 67%～95.8% 的降幅。
❓ 常见问题
H3: 文档会写得像机器人吗？
像空客维修手册：平实、不可能误读。这正是技术文档的目的——把"人设"留给博客，把"无歧义"留给文档。
H3: 直接提示"写得清楚点"不行吗？
"清楚"是观点，"句子不超 20 词"是规格。Agent 只会服从规格。
H3: 两种模式怎么选？
默认 Pragmatic（实用）模式保留你的领域词（如 webhook、idempotent）；提到 STE 或合规时进入 Strict（严格）模式，套用完整词汇表纪律。
🎯 小结
SimpleEnglish 安装只需一条命令：通用工具走 skills CLI，Claude Code 和 Codex 走插件，网页版粘贴提示词。3 分钟装完，之后所有技术文档自动以航空手册标准输出。规则来源与许可证见 README.md 和 LICENSE（MIT）。
【免费下载链接】SimpleEnglishAgent skill: make LLMs write docs in ASD-STE100 Simplified Technical项目地址: https://gitcode.com/gh_mirrors/si/SimpleEnglish
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考