工程规范技能包 chenyinrusi/dsh-engineering-skills

dsh-engineering-skills

从大型生产级智能体系统代码库中提炼出的工程规范技能：系统化代码审查、CI 失败排查、shell 安全、冗余与边界审计、跨仓库模式吸收，以及发布工程。

六个 markdown 技能，面向 AI 编程智能体（DeepSeek Harness、Claude Code、Codex，或任何能读取 SKILL.md 的智能体）。它们以方法论为先——无需安装代码，没有运行时，不锁定平台：复制 skills/ 目录，智能体就会加载。

技能

| 技能 | 作用 |
| code-review-methodology | 18 个维度、3 轮代码审查框架：执行/集成 → 架构/系统 → 可靠性/正确性，外加多角度迭代审查、E2E 测试审查角度、迁移审查角度，以及 12+ 条派生规则 |
| ci-diagnosis-and-fix | GitHub Actions CI 全线飘红时的系统化排查与修复：找到失败的 run → 拉取失败步骤的日志 → 归类根因 → 修复 → 验证 |
| shell-safety | 硬性禁止交互式命令行命令（more/less/pause/choice/start /WAIT），它们会卡死无头智能体会话；给出非交互式替代方案、强制超时规则，以及起飞前检查清单 |
| redundancy-and-boundary-audit | 仓库级重复排查，配可证伪的同步测试和 A/B/C 分类（真重复 / 同名不同概念 / 同形不同领域），外加边界、命名和多角度验证 |
| repo-analysis | 5 阶段跨仓库架构审计：扫描 → 模式提取（7 种原语分类法）→ 差距映射 → 价值判断 → 结构化输出，并附 5 个以上仓库的批量流程 |
| release-engineering | 把 Python 包端到端发布到 GitHub + PyPI + awesome 列表：名称可用性检查、data-files 打包（含 glob 扁平化陷阱）、仓库/tag/topics、twine 上传、干净 venv 验证，以及一仓库一 PR 的聚合条目 |

安装

从 PyPI 安装——这个包同时也以纯数据 Python 包的形式发布，带安装器命令行：

pip install "dsh-engineering-skills"
dsh-engineering-skills list # see the 6 skills
dsh-engineering-skills install ~/.dsh/skills # DeepSeek Harness user skills dir

wheel 里包含同样的 SKILL.md 文件（以 data-files 打包，无代码依赖）；命令行只是把它们复制到任意智能体的技能目录。

从源码安装 / 通用智能体——把技能复制到你的智能体技能目录：

DeepSeek Harness (user-level skills dir is ~/.dsh/skills, i.e. $DSH_HOME/skills)
cp -r skills/* ~/.dsh/skills/

Claude Code
cp -r skills/* ~/.claude/skills/

Codex
cp -r skills/* ~/.codex/skills/
每个技能都是一个自包含的 SKILL.md，带 YAML frontmatter（name、description、keywords）——没有依赖，也不需要构建步骤。

为什么是这些技能

它们来自真实事故和审计，不是纸上谈兵。几个值得一提的来历：

- shell-safety 之所以存在，是因为某次会话在 findstr ... | more +0 上卡了 12 分钟，一直等一个永远不会到来的按键。
- redundancy-and-boundary-audit 固化了 A/B/C 重复分类法，避免把「同名」当成「重复」——领域模型和 API DTO 成对出现是合理的分层，只有非对称变更才算漂移。
- code-review-methodology 里的审查角度，每一个都是先抓到真实 bug 才被收录（单轮审查在横切特性上只能发现约 30% 的 bug）。
- ci-diagnosis-and-fix 记录了两类会让 CI 全线飘红的故障：依赖版本根本不存在，以及在新版 runner 上用了旧的 $GITHUB_OUTPUT 语法。
- release-engineering 固化的流程，经过三次同日发布验证（一个 CLI+MCP 审计工具、一个 MCP 服务器，以及这个技能包）：PyPI 名称冲突、data-files 路径被压平、token 权限不足、requires-python 与 verify-venv 不匹配——每个都踩过一次坑，现在都写下来了。

校验

python scripts/validate_skills.py # checks frontmatter + body of every SKILL.md

许可证

MIT © 2026 Chen (Jarry) Pan