dyslex.ia

Dyslex.ai

Dyslex.ai 是面向 AI Agent 的认知无障碍技能插件。

它帮助 Agent 减少人机交互循环中的阻碍：表达意图、从不完善的措辞中还原含义、保留技术细节、管理认知负荷，以及清晰地呈现下一步操作。

Dyslex.ai 不会诊断残障、提供医疗建议，也不声称具有医疗效益。

快速入门

• Codex
• Claude Code
• Antigravity
• Cursor
• Factory Droid
• GitHub Copilot CLI
• Kimi Code
• OpenCode
• Pi

工作原理

Dyslex.ai 是一个仅包含技能的插件，采用基于证据的认知模型。

该插件通过以下方式提供可重复使用的 Agent Skills：

.codex-plugin/plugin.json
skills/
src/cognitive/

当出现匹配的任务时，Agent 可以使用相关技能来减少特定的功能性阻碍。该项目将基于证据的机制映射到交互风险，再映射到具体的 Agent 行为。

scientific knowledge
  -> functional model
  -> interaction risk
  -> adaptation strategy
  -> skill behavior

我们的目标不是取代 Agent 的推理或 Superpowers 工作流，而是让该工作流更易于遵循、更容易安全地恢复，也更不容易被误读。

每项技能都会先检查是否已安装 Superpowers。如果缺少 Superpowers 或无法确认其状态，Agent 必须停止，并要求用户先安装 Superpowers，再应用 Dyslex.ai。

安装

Codex

公开发布后，首选方式：

/plugins

搜索：

Dyslex.ai

从已配置的市场通过 CLI 安装（如果可用）：

codex plugin add dyslex-ai@openai-curated

如果 Dyslex.ai 尚未显示在公开插件目录中，请使用以下备用方式：

codex plugin add dyslex-ai@npm:@firou91/dyslex.ai

安装后启动新的 Codex 会话，以便加载技能。

本地软件包

npm 软件包发布为：

npm install @firou91/dyslex.ai

CLI 命令为：

dyslexai doctor --verbose

基本工作流

1. 在目标 Agent 中安装 Superpowers。
2. 将 Dyslex.ai 安装为插件。
3. 启动新会话，以便使用这些技能。
4. 像平常一样提问，可以包含杂乱文本、含糊指令、原始错误信息或冗长输出。
5. Dyslex.ai 检测相关的无障碍技能。
6. 该技能会保留命令、路径、软件包名称、环境变量及其他技术标记。
7. Agent 只会在存在实质性歧义时，于采取行动前进行澄清。
8. 回复采用便于阅读和核验的结构。

内容概览

Dyslex.ai 目前包含 16 项技能，以及一个用于证据、功能维度和适配规则的共享认知模型。

可读性与写作

• accessible-response：将回答调整为更清晰的段落，同时不丢失细节。
• spelling-and-writing-support：在保留语气的同时更正、校对或改写文本。
• typo-tolerant-intent：根据拼写错误或不规范措辞推断可能的意图。
• identifier-safety：保护路径、命令、URL、软件包名称、变量、哈希值和正则表达式。

调试

• error-decoder：将原始错误、堆栈跟踪和日志转化为清晰易懂的说明。
• terminal-output-reader：总结杂乱的终端输出，同时不掩盖失败信息。
• diff-reader：根据差异或补丁说明变更、风险和测试需求。
• code-explainer：分层讲解源代码，方便理解。

协作

• instruction-decoder：解析密集的提示词、问题、规格说明或任务描述。
• prompt-clarifier：只提出会实质性影响结果的问题。
• task-sequencer：将工作拆分为有顺序的步骤，并标明依赖关系和检查项。
• decision-comparator：比较选项，并在需要时给出明确建议。
• number-and-date-clarifier：澄清含糊的日期、单位、版本、十进制数和范围。

元技能与连续性

• context-reentry：在暂停、上下文压缩或切换任务后恢复中断的工作。
• documentation-navigator：确定哪些文档与任务相关，以及哪些是必需的、哪些是建议阅读的。
• accessible-superpowers：以更易理解的方式呈现 Superpowers 工作流，同时不削弱其要求。

理念

Dyslex.ai 围绕一条简单原则构建：无障碍应减少认知摩擦，同时不牺牲技术精确性或用户自主权。

这意味着：

• 根据功能需求调整，而非诊断标签；
• 保留准确的技术标记；
• 区分事实与假设；
• 少提问，但问得更好；
• 明确成功标准；
• 让警告和失败清晰可见；
• 避免医疗声明；
• 避免伪神经科学；
• 将缺乏依据的想法视为假设或偏好；
• 尊重 Superpowers 作为工作流的权威。

该项目并非要让 Agent 变得更温和或降低严谨性，而是要让严谨的工作更易于阅读、继续和验证。

科学模型

首份研究与架构报告见 DYSLEX.AI — 科学交互模型。

该模型避免基于诊断设置模式，而是采用以下功能维度：

• 工作记忆负荷；
• 拼写变化；
• 词汇提取的不确定性；
• 阅读速度负荷；
• 数字歧义；
• 排序与规划负荷；
• 界面与工具操作负担；
• 过度适配风险。

品牌形象

以下说明我们如何将极简的视觉形象与 Dyslex.ai 的角色、名称和理念联系起来。

请阅读完整的视觉形象说明：品牌形象。

支持

在各个公共 Agent 生态中发布和维护 Dyslex.ai 需要投入时间和 API 令牌。公开提供无障碍插件通常需要反复审核、多轮测试、针对特定模型的验证，以及持续进行兼容性检查。

Codex 已确定为首个公开部署目标。

社区支持将决定接下来的部署目标：

• 1,000 个 GitHub 星标：公开部署到 Claude Code。
• 5,000 个 GitHub 星标：面向 Cursor 和其他计划支持的宿主公开发布插件。

你可以通过以下方式支持该项目：

• 为代码仓库点星；
• 在实际工作流中测试 Dyslex.ai；
• 报告不清楚的行为；
• 提出无障碍改进建议；
• 分享可复现的提示词，说明这些技能在哪些情况下有帮助或失效。

文档

• 架构
• 安装
• Codex CLI
• 插件端到端发布
• 兼容性
• 安全
• 无障碍
• 发布