Skills

deep-standard-skill

dsh-external/deep-standard-skill · ★ 0

dsh-external

An executable engineering-standards system skill (skill directory layout).

README body is shown in Chinese.

License
MIT
Added
2026-08-17
Maintenance
active
Install kind
github
Manifest details
Manifest status
Not verified
Manifest path
-
Manifest checked
2026-08-17
Lifecycle scripts
None found

Static manifest checks report declarations only; they are not compatibility or security review.

安装

dsh plugin --profile web add github:dsh-external/deep-standard-skill

GitHub 源码安装:首次需按提示配置 allowBuilds 构建授权后重试

For install and environment setup, plus plugin development tutorials, see DSH community docs ↗

README

Source README · body: zh · Read Chinese README

Table of contents
  1. 它解决什么
  2. 什么时候不要装
  3. 安装
  4. skit(推荐)
  5. 手动安装
  6. 技能
  7. 依赖
  8. 致谢与参考
  9. 许可

它解决什么

绝大多数项目的"工程规范"是一份没人读、没人查、逐月腐烂的文档。当主要维护者是会被随时终止、下次只能靠文件系统恢复上下文的 agent 时,这个问题会被放大:任何只存在于对话历史里的约定,等于不存在。

本技能给出六条可落地的法则,并把它们变成可执行、可审计的机制:

法则 一句话
常驻规则分层 每个 session 都要知道的规则集中在一个有字数上限的文件里,每条只链接不复述;一个事实一个家
门禁即代码 机械可查的约定必须有一个只拒绝一条不变量的程序;门禁必须用非法样例证明自己会拒绝
决策记录生命周期 决策记录的状态编码在路径里,备选方案强制填写,归档即永久冻结
最小充分证据 每个改动只跑覆盖它所触及表面的最窄证据,一次;hook 窄、CI 全
散文即契约 注释与文档写契约,不写推理转录;只写当前态
落地纪律 一个 PR 一种性质;在引入问题的 PR 上修,而不是往下游打补丁

配套提供三档采纳阶梯(L1/L2/L3):小项目只装常驻规则、决策记录和一个链接门禁,不会被整套体系压垮。

什么时候不要装

  • 一次性脚本、实验代码、生命周期以周计的项目——收益不足以抵消成本。
  • 只想装文档层、不打算真的建门禁。那样只会又造一份没人查的规范,正是本体系要消灭的东西。

安装

skit(推荐)

skit install https://github.com/vlln/deep-standard-skill/tree/main/skills/deep-standard

手动安装

Agent 命令
Claude Code cp -r skills/deep-standard .claude/skills/
Codex cp -r skills/deep-standard ~/.codex/skills/
OpenCode git clone https://github.com/vlln/deep-standard-skill.git ~/.opencode/skills/deep-standard-skill
任意 Agent(符号链接) ln -s <repo>/skills/deep-standard <agent-skills-dir>/deep-standard

技能

技能 说明
deep-standard 为项目建立或审计工程规范:门禁体系、决策记录、证据选择、文档分层、散文契约、PR 纪律

技能内含可直接实例化的模板(常驻规则文件、文档分层表、决策记录契约与骨架、字数预算 manifest),位于 skills/deep-standard/assets/templates/。

依赖

无。技能不含可执行脚本——门禁按各项目自己的技术栈实现,技能提供的是门禁的验收契约而不是现成脚本。

致谢与参考

本体系蒸馏自 DeepSeek Harness —— 一个由 agent 长期维护的大型 monorepo 的工程实践。六条法则、采纳阶梯与门禁自证机制均从该项目的实际运作中提炼,剥离了框架与语言相关的部分后泛化而来。

方法论的组织形式(可迁移的 agent skill、状态化的推进流程、模板即资产)参考了 devloop —— 一套契约驱动的项目开发系统。

许可

MIT