dsh-generalized-skills
September 5, 2026 · View on GitHub
中文 | English
把上游 deepseek-harness 仓库中的 AI agent skills 进行通用化改造,并统一存放、归档、管理、跟进变更的仓库。
改造后的 skills 提供不绑定特定 AI Agent 或代码仓库的方法,依据当前任务、已有授权和项目约定选择执行方式。浏览器录制、Git 操作等能力仍需要所在环境提供相应工具。
特性
- Agent 无关:技能不要求特定 Agent 的元数据、子代理机制或调用接口;具体命令作为可适配的工具用法,而非唯一执行方式。
- 遵循项目约定:技能提供判断依据,不替项目建立文档层级、双语哈希、归档制度或发布流程。
- 可溯源:每个 skill 的改造原因、改造计划与改造前后差异均有权威记录,可随时对照上游仓库的对应版本。
- 持续跟进:仓库持续跟进上游变更,每次改动以版本化 changelog 完整归档。
当前包含的 skills
| Skill | 作用 |
|---|---|
prose-standard | 写作与审校核心;按需读取文档结构、会话痕迹清理和反例 |
find-simplifications | 根据调用方、兼容性和维护成本提出简化建议;分析默认在对话中报告 |
code-review | 按正确性、生命周期、安全及实际影响审查变更 |
pre-push-checks | 依据实际 diff、仓库规则和风险选择验证,核对发布结果 |
translate-docs | 自然翻译与最小双语同步;沿用项目命名、术语和验证方式 |
merging-stacked-prs | 根据实际依赖和可用工具合并 PR,验证各层合并结果 |
record-browser-gif | 录制与验证浏览器演示 GIF;按任务区分行为证据及媒体发布 |
archive-decision-records | 判断决策记录的当前价值,并在授权范围内按项目规则归档 |
快速开始
通过 skills.sh 安装
本仓库的 skills 已注册到 skills.sh 注册表,可直接用官方 CLI 安装到任意支持 skill 机制的 AI Agent:
# 使用 npx
npx skills add HanZephyr/dsh-generalized-skills
# 或使用 pnpm dlx
pnpm dlx skills add HanZephyr/dsh-generalized-skills
只安装某一个 skill(以 prose-standard 为例):
npx skills add HanZephyr/dsh-generalized-skills/prose-standard
注:具体命令语法以 skills CLI 当前版本文档为准。
手动安装
- 将
skills/<skill-name>/目录复制(或软链)到你所用 AI Agent 工具的 skills 目录中。 - 在对话中描述需求,例如"用 prose-standard 审查这份文档",AI Agent 会自动载入对应 skill 并按其
SKILL.md的指引执行。 - 具体安装位置与加载方式取决于你使用的工具,请参考该工具对 skill 的支持文档。
仓库结构
| 路径 | 说明 |
|---|---|
skills/ | 通用化改造后的 skills(每个 skill 一个目录,含 SKILL.md 与参考材料) |
transformation.md | 当前版本改造的权威记录:改造原因、计划、前后差异,以及未改造 skill 列表及原因 |
skills-changelog/ | 按版本归档的变更记录(v<n>.md,小版本在同一文件内追加) |
templates/ | transformation 与 changelog 的编写模板 |
refrences/deepseek-harness | 上游仓库本地 checkout(git 忽略,仅作改造对比基线) |
当前状态
当前版本为 v3.0,发布 8 个独立技能,覆盖 10 个上游技能。doc-standards 与 trim-cot-leakage 已合并到 prose-standard 的参考材料中。完整改造见 transformation.md,本次变化见 v3.0 日志。
升级时使用新的 prose-standard,并移除旧安装中的 doc-standards、trim-cot-leakage,避免重复触发。本仓库源码更新不会自动同步本机已安装副本。
未通用化改造的 skills 列表及原因
以下上游 skill 尚未完成通用化改造(完整记录见 transformation.md):
| Skill | 未改造原因(摘要) | 改造计划 | 优先级 |
|---|---|---|---|
dsh-doc-site-sync | 完全绑定该仓库的 VitePress 投影管线 | 无 | - |