前言¶
接口、模块或服务一旦上线，CPU 飙高、限流误配、熔断未测等场景往往要到压测或事故里才暴露。手工加混沌脚本或中间件样板，容易和当前改动脱节，也拖慢迭代。下面介绍 SkillHub 上的「混沌工程」技能：在生成代码、改代码或创建涉及接口/模块/服务的需求时，由 Agent 按规则询问是否做瓶颈注入及类型，并依托内置脚本与 Web 框架中间件模板落地，而不是事后单独补一套混沌工程流程。
这是什么¶
「混沌工程」是 SkillHub 坐标 @user_aca7c22a/fault-injection 上的社区来源技能（发布者 user_aca7c22a，版本 1.0.0，分类 dev-programming）。它面向故障注入与性能瓶颈注入：在符合条件的编码与需求场景里，自动向用户确认是否注入、注入哪类瓶颈，并配合多语言项目使用内置注入能力与模板。标签标明 requires_api_key=false，无需额外 API Key。
官方入口：
- API：
https://api.skillhub.cn/user_aca7c22a/fault-injection - 页面：
https://www.skillhub.cn/skills/user_aca7c22a/fault-injection
核心功能¶
以下能力均来自 SkillHub 页面简介，未在资料中出现的细节不展开。
触发条件
在以下情形会进入该 Skill 的工作流：
- 生成代码
- 修改代码
- 创建需求（且涉及接口、模块或服务）
交互方式
满足触发条件后，Agent 会自动询问是否进行瓶颈注入，以及注入类型，避免在未授权时改动工程。
九种瓶颈类型
CPU、内存、IO、网络、并发、数据库、限流、熔断、资源耗尽。
语言与交付物
支持 14 种语言：Python、JavaScript、TypeScript、Java、Go、Rust、C#、Ruby、PHP、Kotlin、Swift、C++、Zig、Dart。技能内置自动注入脚本和 Web 框架中间件模板，用于把选定类型的瓶颈接到当前技术栈。
安装与启用¶
SkillHub 提供两种常见安装路径：用 CLI 装到当前 Agent 的 skills 目录，或把安装提示交给 AI 按官方文档执行。
1、安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，可用官方脚本（完整安装含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装「混沌工程」到对应 Agent 目录¶
安装技能时必须用 --dir 指向当前 Agent 的 skills 目录；默认装到 ./skills/ 时，多数客户端不会自动加载。
skillhub install user_aca7c22a/fault-injection --dir <skills 目录>
常用路径（来自 SkillHub 安装文档）：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
Cursor 示例：
skillhub install user_aca7c22a/fault-injection --dir ~/.cursor/skills/
3、通过 AI 安装¶
SkillHub 页面给出的提示为：根据 https://skillhub.cn/install/skillhub.md 安装 @user_aca7c22a/fault-injection。在对话里把该句发给 Agent 即可走同一套安装流程。
安装或更新 skills 后，按你所用客户端说明重启或刷新 Agent，使 SKILL.md 被加载。
典型用法¶
资料未提供独立的长示例仓库；可复现的流程以官方描述为准：
- 在已启用该 Skill 的 Agent 中，发起生成/修改代码，或创建涉及接口、模块、服务的需求。
- 等待 Agent 询问：是否进行瓶颈注入、选择哪一种（九类之一）。
- 确认后，Agent 结合项目语言（14 种之一）选用内置自动注入脚本或 Web 框架中间件模板，把选定瓶颈接到当前改动范围内。
具体注入代码形态以技能包内 SKILL.md 与模板为准；本文不臆造文件名或配置字段。
适用场景与注意¶
适合谁
- 在开发阶段就想顺带验证限流、熔断、资源耗尽等行为的团队。
- 多语言微服务或 Web 服务，希望少手写混沌样板、由 Agent 在改代码时对齐注入点。
限制与注意
- 瓶颈注入会改变运行时行为，仅在测试、预发或明确隔离的环境使用；生产环境需自有变更与审批流程，不能仅凭 Skill 默认交互代替治理。
- 触发面较宽（生成/修改代码及相关需求），若不希望每次都被询问，需在对话里明确跳过注入，或按团队规范管理已安装的 Skill。
- 社区来源（
community），版本为1.0.0；升级与行为变更以 SkillHub 上该坐标为准。
SkillHub 页面统计（撰写时以商店展示为准）：评分 100000，下载 869，安装 24。
结尾¶
「混沌工程」把故障与九类性能瓶颈注入嵌进日常写码与需求场景，用询问式交互和多语言模板降低接入成本。需要安装或查看说明时，请打开 SkillHub 技能页 或 API 地址 https://api.skillhub.cn/user_aca7c22a/fault-injection。
