1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | skill-temporal-developer |
| 项目自述名称 | Temporal Development Skill（SKILL.md 内部 name: temporal-developer） |
| 作者/维护者 | Temporal Technologies Inc.（Temporal.io 官方） |
| 来源链接 | https://github.com/temporalio/skill-temporal-developer |
| 许可证 | MIT（GitHub API 获取） |
| GitHub Stars | 195（GitHub API） |
| Forks | 28（GitHub API） |
| 最新版本 | 0.5.0（SKILL.md frontmatter） |
| 安装方式 | npx skills add / 各 Agent 专属插件 / 手动 git clone |
2. 功能介绍与亮点
为 AI coding agent 注入 Temporal 工作流编程模型的专家级知识：确定性规则、activity 重试模式、signal/query/heartbeat 原语、版本兼容（versioning）、continue-as-new、saga 模式，以及 non-determinism 报错、workflow 卡死等常见踩坑的排查方法。
- 官方出品：2026-03-20 发布，持续维护。
- 多语言：Python/TypeScript/Go/Java/.NET/Ruby 完整支持，Rust 为 Preview，PHP 开发中。
- 两级加载：启动仅占约 100 token，检测到 Temporal 代码才展开完整内容，日常零开销。
- 开放标准：遵循 Agent Skills 开放规范，非私有格式。
3. 适用场景
固定分类：工程效率与代码质量
适用于使用 Temporal SDK（Python/TypeScript/Go/Java/.NET/Ruby）构建持久化工作流应用的开发者：编写 workflow/activity 代码、排查 non-determinism 等疑难问题、处理版本升级，或需要在编码 agent 内直接获得 Temporal 最佳实践参考。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | ✅ 原生支持 | 官方提供专属插件仓库 temporalio/claude-temporal-plugin，可通过插件市场安装 |
| Codex | ✅ 原生支持 | 官方提供专属插件仓库 temporalio/codex-temporal-plugin，README 明确列出 OpenAI Codex |
| OpenClaw | ❓ 未验证 | 已抓取材料未提及，遵循规则不为兼容性单独发起搜索 |
| Hermes Agent | ❓ 未验证 | 已抓取材料未提及，遵循规则不为兼容性单独发起搜索 |
5. 推荐理由
Temporal 官方出品，覆盖 7 种语言，教 Agent 写出正确的持久化工作流代码。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Temporal 为知名分布式工作流编排平台官方仓库；195 Stars/28 Forks，且已有独立第三方评测与官方发布博客等多来源讨论，但受众相对垂直（分布式系统/后端工程师），未达大众级热度 |
| 可用性 | 8 | npx skills add 一条命令即可安装，SKILL.md 与 7 种语言的 references 文档齐全，v0.5.0，2026-07-09 仍有提交，维护活跃；第三方评测指出部分指引路由不够精确、易踩坑内容被埋在参考文件深处，故未给满分 |
| 安全性 | 9 | 纯文档/参考型 Skill，不捆绑可执行脚本，不会自动联网外发数据；MIT 协议清晰；官方机构出品、仓库可审计；近期持续维护 |
7. 跟同类 Skills 相比的优势
| 竞品 | 定位 | 与本 Skill 的差异 |
|---|---|---|
| temporal-claude-skill（社区，mfateev） | 早期个人开发者制作的 Temporal Claude Code 参考技能，早于官方版本出现 | 未附带开源许可证声明，内容覆盖面与更新频率均不及官方版本，且缺少官方持续维护 |
| skill-temporal-design（Temporal 官方） | 官方另一款技能，专注于工作流设计方案的审查与评估 | 面向架构设计评审场景，不涉及具体语言的编码实现细节，与本 Skill（日常编码陷阱与实现指导）互补而非重叠 |
| Temporal Knowledge Base MCP Server（Temporal 官方） | 通过 MCP 协议实时查询官方文档、社区论坛与 Slack 沉淀的问答 | 提供的是实时检索的最新文档内容，而非固化进 Agent 的领域知识；两者定位互补，一个胜在时效性，一个胜在离线即用、无需额外登录鉴权 |
8. 用户评价
- Steve Kinney（独立开发者/技术写作者，个人博客 stevekinney.com）：《Temporal’s Developer Skill Is a Promising First Draft》一文评价“架构方向正确”，认可两级加载设计与采用开放规范的选择，同时指出指引路由不够具体、常见踩坑被埋在参考文件深处等改进空间，总体结论为“一份有前景的初稿”。
9. 其他补充
发布以来已迭代 7 个版本、逾百次提交；官方设 Slack #topic-ai 频道接收反馈。
10. 安装使用方式
方式一（推荐，通用）：
npx skills add temporalio/skill-temporal-developer方式二（手动克隆）：
mkdir -p ~/.claude/skills
git clone https://github.com/temporalio/skill-temporal-developer ~/.claude/skills/temporal-developer方式三（Agent 专属插件，自动接收更新）：Claude Code 用 temporalio/claude-temporal-plugin、Codex 用 temporalio/codex-temporal-plugin，步骤见对应仓库 README。
安装后无需重启，检测到相关代码或关键词自动激活，无需额外 API Key；涉及 Temporal Cloud 时需用户自有凭据。
11. 注意事项
- Rust 为 Preview，PHP 开发中，未覆盖全部 7 种语言。
- 常见踩坑分散在语言专属参考文件中而非主体，初次使用需多翻几层文档定位。
- 仅提供开发期编码指导，无法连接线上集群做实时运维排查，生产故障排查仍需人工或 MCP Server 等工具。
- 需自备 Temporal Server/Cloud 运行环境，技能本身不提供该基础设施。