2005selene2005-a11y/cn-dev-skills

cn-dev-skills 🇨🇳

面向 AI 编程代理的中国开发层。

镜像。小程序。中国云。国内 API。网络怪癖。一层搞定。

AI 编程代理很强大。但它们默认身处一个 GitHub 80ms 就能加载、npm 从不超时、每个项目都部署到 AWS 的世界。

cn-dev-skills 就是那块缺失的拼图，让它们理解中国的开发环境。

之前 / 之后

网络 （network-fix 代理技能）
之前：  npm install → ETIMEDOUT  →  代理重试 3 次，放弃
之后：  代理检测：404？权限错误？还是连接问题？
→ 确认是 registry 延迟问题
→ 推荐切换镜像并附带回滚说明
（由你决定是否应用）

微信小程序
之前：  "构建一个小程序" → 代理写 React +   ✗
之后：  代理写 WXML + wx.* + setData + rpx 单位        ✓

部署
之前：  "为中国用户部署" → 代理建议 AWS + CloudFront
之后：  代理询问区域 → 推荐阿里云 / ICP 备案提示 / CDN

🩺 cn-doctor — 环境诊断

运行真实的环境检查。无需 Claude Code —— 可在任何终端中独立运行。

python3 doctor/doctor.py

示例输出（结果取决于你的环境）：

════════════════════════════════════════════════════════
🇨🇳  中国开发环境检查  cn-doctor v0.1.1
════════════════════════════════════════════════════════

网络  ───────────────────────────────────────────
npm        官方         2341ms    镜像         43ms
PyPI       官方         1893ms    镜像         52ms
✓ GitHub                           1203ms
✗ Docker Hub                       无响应

↳ 单次请求检查。结果会因 DNS 缓存、CDN
和瞬时负载而变化。并非持续基准测试。

配置  ─────────────────────────────────────
⚠  npm registry   https://registry.npmjs.org/
⚠  pip index      （未设置）
⚠  docker         未配置 registry 镜像

诊断  ─────────────────────────────────────────
✗ npm
└─ 本次检查无响应；镜像可达
→ npm config set registry https://registry.npmmirror.com

以上建议均为只读提示。
应用前请自行审阅。--fix 标志将在 v0.2 推出。
════════════════════════════════════════════════════════

cn-doctor 测量你的环境 —— 它不会改变任何东西。
建议均为只读。由你决定应用什么。

需要 Python 3.8+。零外部依赖。

🚀 快速开始

git clone https://github.com/2005selene2005-a11y/cn-dev-skills.git
cd cn-dev-skills
python3 doctor/doctor.py        # Linux / macOS / WSL

.\doctor.ps1                    # Windows PowerShell

已在以下环境测试： Ubuntu 24.04 LTS，Python 3.12。
macOS 和 Windows（PowerShell）在设计上受支持，但尚未经过端到端验证。
如果你在其他平台上遇到问题，请提交 Issue。
其他入口（全部等价）：

./doctor.sh                     # Linux / macOS shell 包装脚本
python3 -m doctor               # 作为 Python 模块运行（从项目根目录）
python3 doctor/doctor.py --version  # 打印版本并退出

安装 agent 技能：

bash install.sh                 # 自动检测 Claude Code / DSH / Cursor

当前可用功能

| 功能 | 状态 |
|---------|--------|
| 环境诊断（网络、配置、项目） | ✅ v0.1.1 |
| 官方源与镜像源延迟对比 | ✅ v0.1.1 |
| 带回滚信息的只读建议 | ✅ v0.1.1 |
| 项目检测（微信 / uni-app / Taro） | ✅ v0.1.1 |
| network-fix agent 技能 | ✅ v0.1 |
| api-router agent 技能 | ✅ v0.1 |
| miniapp agent 技能 | ✅ v0.1 |
| cn-style agent 技能 | ✅ v0.1 |
| cn-deploy agent 技能 | ✅ v0.1 |

后续计划

| 功能 | 目标版本 |
|---------|--------|
| --fix 标志（安全自动修复 + 回滚） | v0.2 |
| 多次采样 / 延迟中位数 | v0.2–v0.3 |
| 根据项目文件自动加载技能 | v0.3 |
| Trae CN 支持 | v0.4 |

🧩 技能

安装一次，即可用于 Claude Code · DeepSeek Harness (DSH) · Cursor · Kiro · OpenCode。

| 技能 | 解决的问题 | 触发条件 |
|-------|--------|---------|
| network-fix | npm/pip/brew 超时、GitHub 缓慢、镜像切换 | npm install 失败 |
| api-router | 将任务路由到成本更低的模型，把强模型留给复杂工作 | 提及预算 / 配额 |
| miniapp | 微信小程序 + uni-app，阻止 agent 编写 React | 小程序 / uni-app |
| cn-style | 中文注释、双语文档、命名规范 | 代码审查 / 文档 |
| cn-deploy | 阿里云 / 腾讯云 / 华为云部署 | 部署 + 中国云 |

手动安装技能

Claude Code（全局）
cp -r skills/ ~/.claude/skills/

DeepSeek Harness
cp -r skills/ ~/.dsh/skills/

Cursor / Kiro
cp -r skills/ .cursor/skills/

所有 agent（自动检测）
bash install.sh

贡献

遇到了尚未覆盖的中国特有痛点？提交 issue 或 PR。
技能格式：一个包含触发条件和决策树的 SKILL.md。

许可证

MIT © 2026 2005selene2005-a11y

⭐ 如果这对你有帮助，请点个 Star——这能帮助更多中国开发者发现它。