1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | mirai-posit-dev-skills |
| 作者/维护者 | Charlie Gao（@shikokuchuo，mirai R 包的创建者与维护者）；技能收录与后续同步由 Posit 工程师 Garrick Aden-Buie（@gadenbuie）协同完成 |
| 来源链接 | https://github.com/posit-dev/skills/tree/main/r-lib/mirai |
| 许可证 | MIT（GitHub API 数据） |
| GitHub Stars | 443（GitHub API 数据；为合集仓库 posit-dev/skills 整体数字，不代表本技能自身热度） |
| Forks | 35（GitHub API 数据，合集仓库整体） |
| 最新版本 | SKILL.md 元数据标注 version 1.2 |
| 安装方式 | npx skills add、Claude Code 插件市场、或手动复制子目录 |
2. 功能介绍与亮点
这是一份指导如何正确使用 mirai（R 生态中的极简异步/并行/分布式计算框架）的技能，覆盖：显式依赖传递规则（.args vs ... 的区别与常见踩坑）；本地/远程/HPC 集群（Slurm、SGE、PBS、LSF）daemon 的搭建与作用域管理；mirai_map() 并行映射（含进度条、提前失败、多参数映射）；内存背压控制（memory 参数配合 try_mirai()）；与 Shiny/promises 的集成模式（ExtendedTask）；SSH 直连与隧道式远程计算配置；以及从 future 包、parallel 包迁移到 mirai 的对照表。
最突出的亮点：该技能由 mirai 包的原作者本人参与撰写与维护，且 mirai 包自身的官方仓库 r-lib/mirai 在其开发者文档 CLAUDE.md 中明确写明——面向终端用户的 mirai 使用指导应交给这份技能，而非仓库内部的开发者文档，原文为 “The same skill ships to end users via the r-lib plugin in posit-dev/skills”。技能内容近期曾随 mirai 2.7.0 版本发布同步更新。
3. 适用场景
所属分类：工程效率与代码质量
面向需要在 R 中编写异步、并行或分布式计算代码的开发者：将耗时计算任务转移到后台 daemon 执行、为 Shiny 应用接入非阻塞的长任务处理、把已有的 future 或 parallel 代码迁移到 mirai、或需要在多机/HPC 集群上调度 R 任务。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 官方 README 提供两条原生安装路径：/plugin marketplace add posit-dev/skills 插件市场安装，以及 npx skills add 通用安装 |
| Codex | 需适配 | 通过第三方分发工具 vercel-labs/skills 的 npx skills add 安装；该工具源码 src/agents.ts 明确定义 codex 目标（写入 .codex/skills 或 CODEX_HOME 指向目录），非仓库原生集成 |
| OpenClaw | 需适配 | 同一分发工具源码明确定义 openclaw 目标（探测 .openclaw/.clawdbot/.moltbot 并写入对应 skills 目录），同样依赖第三方安装器而非仓库原生支持 |
| Hermes Agent | 需适配 | 同一分发工具源码明确定义 hermes-agent 目标（写入 .hermes/skills 或 HERMES_HOME 指向目录），同样依赖第三方安装器 |
5. 推荐理由
正确使用 mirai 的最大门槛是显式依赖传递规则（daemon 是干净环境，调用环境中的对象不会自动可用），新手极易在这里踩坑。本技能由包的原作者亲自撰写并保持与包版本同步，把这些细节、daemon 管理、Shiny 集成与迁移路径整理成可直接复用的代码示例，可信度和准确性都有第一手保障。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 属官方多技能合集仓库中的独立子目录，合集整体 stars 不计入个体热度；子目录自身由 mirai 包原作者与 Posit 工程师共同提交维护，且被 mirai 包官方仓库自身的开发者文档明确点名为面向终端用户的权威指南，第三方技能目录 skillsllm.com 已收录列出 |
| 可用性 | 9 | 一条 npx skills add 命令或 Claude Code 插件市场即可安装；单文件文档含数十个可直接运行的 R 代码示例，覆盖本地到 HPC 集群的完整场景；2026-05-15 仍有随包版本同步的维护提交；无付费依赖 |
| 安全性 | 9 | 纯知识/文档类技能，只给出供开发者手动执行的 R 代码建议，不含可自动执行的外部脚本，不联网、不需要凭据；MIT 许可，内容开源可审计 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令及权限范围 | 无 shell 命令；仅提供 R 函数调用建议，需开发者手动执行 |
| ② 运行时联网外发 | 无（daemon 间通信是用户自行配置的 mirai 运行时行为，非技能本身外发数据） |
| ③ API Key/凭据 | 不涉及 |
| ④ 可疑指令 | 未发现 prompt injection 或混淆代码迹象 |
| ⑤ 作者/组织信誉 | 撰写者为可查证的 mirai 包原作者本人，托管于 Posit 官方组织仓库 |
| ⑥ License | MIT，明确 |
| ⑦ 最近维护时间 | 2026-05-15，随包版本同步，非弃置项目 |
7. 跟同类 Skills 相比的优势
| 技能/项目 | 定位 | 与本技能的差异 |
|---|---|---|
| cli（同仓库） | R 包控制台输出与用户消息样式规范 | 解决用户交互展示问题，与异步/并行计算无关 |
| testing-r-packages（同仓库） | testthat 3+ 测试写法（结构、期望、快照、mock） | 处理“如何测试”，与本技能“如何写并行代码”是两个不同环节 |
| swift-concurrency-agent-skill | 面向 Swift 语言 async/await、actor 等结构化并发的正确用法指导 | 定位思路相近（都是“语言级并发正确用法指南”），但服务对象是完全不同的语言生态 |
| future/parallel 包生态 | R 中更早期的异步/并行计算框架，是 mirai 的功能性替代方案 | 截至目前未见官方或社区为其打包对应的 agent skill，本技能内置的迁移对照表可作为衔接 |
8. 用户评价
该技能目前在第三方平台尚无独立具名用户评价。它已被第三方技能目录 skillsllm.com 收录列出，评论区显示尚无人留言。较有分量的第三方确认来自 mirai 包自身的官方仓库：其开发者文档明确将本技能列为面向终端用户的权威使用指南。
9. 其他补充
技能正文为单一 SKILL.md 文件，未附带独立的 references/ 参考子文件；内容仅覆盖 R 语言生态。同一合集仓库内另有 6 份 R 包开发相关技能，覆盖测试、CLI 样式、CRAN 提交、生命周期管理等不同环节。
10. 安装使用方式
方式一：通用安装器（适用于 Claude Code / Codex / OpenClaw / Hermes Agent）
npx skills add posit-dev/skills --skill mirai方式二：Claude Code 插件市场
/plugin marketplace add posit-dev/skills
/plugin install r-lib@posit-dev-skills方式三：手动安装
git clone https://github.com/posit-dev/skills.git
cp -r skills/r-lib/mirai ~/.claude/skills/安装后无需重启，检测到 R 异步/并行/分布式计算相关任务时自动触发。若项目尚未安装 mirai 包，需先执行 install.packages("mirai")。
11. 注意事项
- 仅适用于 R 语言生态。
- 依赖 mirai R 包本身；daemon 的网络配置（尤其 SSH 远程与 HPC 集群部分）需要用户自行具备相应的基础设施访问权限。
- 属于官方多技能合集仓库的一部分，安装时需选择
r-lib分类或单独指定--skill mirai。 - 维护证据集中在两位具名贡献者（含包原作者本人），规模小于依赖更多外部 PR 的姊妹技能。