PerryLink/dsh-skill-pack-security

dsh-skill-pack-security

面向 DeepSeek Harness 的八个安全审计技能 + 一个自动化插件供应链门禁。

技能教审计方法论；plugin_vet 工具执行安装前扫描——许可证 / SBOM / commit 锁定 / 恶意模式 / 五维风险卡片。

English · 简体中文 · Español · Português · हिन्दी

---

Compatibility

维度	状态
Harness	DeepSeek Harness 0.1.0-rc.6
Node	^22.19.0 || >=24.0.0（DeepSeek Harness 运行时）
平台	任意（技能是内容；provider 是 host 插件）
模型	任意（技能经 skill 工具按需加载；plugin_vet 是确定性的）

What you get

dsh-skill-pack-security 是面向 DeepSeek Harness 的技能包 + 供应链门禁。它把 8 套安全方法论做成 SKILL.md 技能（模型在会话目录中发现它们，用 skill 工具按需加载），并附自动化安装前扫描器 plugin_vet。技能教方法论，插件执行静态检查。

• 八个技能、双语双套 —— 每个技能以相同名称与元数据提供 skills/（中文）与 skills-en/（英文）两个版本；每个根目录只装一种语言。
• plugin_vet 门禁 —— 由可选 provider/ 插件注册到 ctx.tools 的零依赖扫描器（许可证 / SBOM / commit 锁定 / 恶意模式 / 数据责任审查 / 五维风险卡片）。
• 发现引用技能 —— 每个发现指向对应技能章节（如 supply-chain-review §1），agent 可继续人工审计。
• 可被模型执行 —— 每个技能步骤都是真实命令（gitleaks、trivy、pnpm audit、npm view、git …），附预期输出样例与退出码判据。

Why skills, not tools?

形态	做什么	做不到什么
工具型插件（如扫描器）	执行扫描、返回发现	解读告警、误报分级、写脱敏报告
协议层	约束某个协议	跨仓库、跨 agent 泛化
技能包（本仓库）	传授方法论：分级、报告、修复排序——并通过 plugin_vet 自动执行安装前静态检查	端到端取代人工审计

与工具型安全插件同装时两者互补：工具负责跑扫描，技能负责解读、分级与报告。本包现在两种形态兼有：技能教方法论，plugin_vet 自动跑机械性的静态子集，每个发现都指回技能继续深挖。

Claude Code 生态 3000+ 技能已经证明这种形态的分发价值。DSH 的 SKILL.md frontmatter（name/description/whenToUse）与 CC 技能格式兼容；本包只用公共子集，内容全部原创。

The eight skills

技能	用途	何时用
security-audit	五阶段审计流程：范围→资产清单→风险分级→验证→报告模板	整体审计、出报告、规划步骤
secret-scan	凭据审计：gitleaks/trivy 用法、误报分级、脱敏报告、修复排序	密钥扫描、告警定真伪、泄露报告
dependency-audit	供应链审计：pnpm/npm audit 解读、license、投毒风险、锁文件漂移	依赖盘点、audit 报告解读
supply-chain-review	PR/新依赖快速评审：危险 install 脚本、typosquat、可复现构建	评审引入新依赖的 PR
prompt-injection-review	agent 项目注入面审查：AGENTS.md、技能、工具描述、MCP、网页	审查模型上下文注入面
threat-model	设计期威胁建模：信任边界、STRIDE 表、攻击树、缓解	新功能建模、设计阶段安全评审
vuln-intel	漏洞情报：NVD/CISA-KEV/GHSA/OSV 检索与判定	拿到 CVE/GHSA 编号后查影响与利用
incident-response	agent 环境事件响应：控制→取证→恢复→复盘	DSH/agent 环境出现疑似安全事件

每个技能主文件 ≤ 300 行（渐进披露，细节在 references/）。

plugin_vet — the automated pre-install gate

plugin_vet 是本包的自动化补充：由 provider/ 插件注册到 ctx.tools 的零依赖扫描器。传入 GitHub owner/repo 或本地包路径即可——一次性下载 tarball（遵守超时与 AbortSignal）、在预算上限内扫描，并返回渲染卡片。

• 许可证扫描 —— 定位 LICENSE 文件与 license 字段；NOASSERTION/UNKNOWN/SEE LICENSE IN <file>、文件缺失或字段缺失都会被标出；常见 SPDX 标识可识别。
• SBOM —— 从锁文件（pnpm/npm/yarn）提取带版本的依赖树。
• commit 锁定 —— 安装清单 ref 与 workflow action 必须是不可变的 40 位 commit SHA；@tag/分支 ref 会被标记为可变。
• 恶意模式 —— 生命周期脚本（preinstall/install/postinstall）、网络回传域名、发布代码中的混淆/编码载荷。
• 数据责任审查 —— 策略扫描三维的确定性规则版：敏感 seam（agent/pre-step、tools/pre-execute、session/event 等）上的无门控监听、README 未披露出站端点、描述-行为关键词覆盖率、随包文本中的指令覆盖类注入载荷（技能/文档/提示词/测试）。每条发现都指向 prompt-injection-review 供人工深审；可用 vet.dataResponsibility: false 按部署关闭。模型辅助审查阶段为已文档化的后续升级。
• 五维风险报告 —— 许可证 / 来源 / 依赖 / 构建脚本 / 维护状态，各 0–100 分，汇总为整体判定：PASS、WARN 或 FAIL。

安装前门禁。 判定结果进入安装门禁——gate.policy: warn（默认，不阻断）在 FAIL 时打印警告；gate.policy: deny 直接阻断安装：

- id: skill-pack-security
  name: '@perrylink/dsh-skill-pack-security-provider'
  config:
    language: en
    vet:
      gate:
        policy: deny   # 阻断 plugin_vet 不过的安装

与 dsh-plugin-check 互补。 官方插件校验器的 36 项检测验证插件的契约与质量（配置 Schema、effect 注册、工具 JSON 形态）；plugin_vet 验证插件的来源供应链是否可信。两者都跑：

	dsh-plugin-check（36 项检测）	plugin_vet（本仓库）
回答的问题	这个插件是否结构良好、符合契约？	这个包安装是否安全？
检查对象	插件代码、Schema、注册、工具契约	LICENSE、锁文件、安装 ref/action、生命周期脚本、回传/混淆、维护状态、数据责任（监听作用域、遥测披露、描述-行为、嵌入式注入载荷）
判定	逐项 pass/fail	PASS / WARN / FAIL + 门禁
时机	插件开发或评审时	dsh plugin add 前、PR 评审、CI 供应链门禁
阻断	CI 门禁（有违规即非零退出）	可配置：warn（默认）或 deny

Quick start

# 1. 把 bundle 安装进 profile
dsh plugin --profile web add "github:PerryLink/dsh-skill-pack-security#main"

# 或从 npm（发布版本）
dsh plugin --profile web add @perrylink/dsh-skill-pack-security-provider

# 2. 重启并校验该行
dsh --profile web --dump-config | grep -A3 'id: skill-pack-security'

Install & uninstall

• git 通道（最新 main）：dsh plugin --profile web add "github:PerryLink/dsh-skill-pack-security#main" —— 挂载 provider bundle；prepack 把双语言版嵌入 tarball。
• npm 通道（发布版本）：dsh plugin --profile web add @perrylink/dsh-skill-pack-security-provider。
• tarball 通道：在 provider/ 里 pnpm pack，再 dsh plugin --profile web add ./@perrylink-dsh-skill-pack-security-provider-<version>.tgz。
• 卸载：dsh plugin --profile web remove @perrylink/dsh-skill-pack-security-provider（或删除该行；纯技能副本用安装器的 -Uninstall / --uninstall 删除）。

Installing the skills by hand

DSH 本地技能提供方按 rank 扫描四个根目录（同层内重名时低 rank 胜出）：

Rank	根目录	适用范围
100	<项目根>/.dsh/skills	项目级、随仓库走
200	<项目根>/.agents/skills	项目级、跨 agent 共享目录
400	<dshHome>/skills（$DSH_HOME 或 ~/.dsh）	用户级、DSH 专用
500	<agentsHome>/skills（$DSH_AGENTS_HOME 或 ~/.agents）	用户级、跨 agent 共享

Rank 链（同层内重名低者胜）：project-dsh 100 < project-agents 200 < custom 300 < user-dsh 400 < user-agents 500。custom 300 是插件注册层（如本包可选的 provider/），不是磁盘根目录。

./scripts/install.ps1 -Target user-agents -Language zh   # Target: project-dsh | project-agents | user-dsh | user-agents；Language: zh（默认）| en

bash ./scripts/install.sh --target user-agents --language en

What's inside

路径	内容
skills/<name>/SKILL.md	8 个技能（中文版）；frontmatter 逐条符合官方 dsh-skill-filesystem 契约
skills-en/<name>/SKILL.md	8 个技能（英文版）；名称与元数据与中文版一致
skills/<name>/references/	渐进披露细节：命令矩阵、分级表、模板
scripts/install.ps1	Windows 一键安装（四种根目录、两种语言版）；记录清单，支持 -Uninstall/-DryRun/-Force
scripts/install.sh	POSIX 等价安装器（--uninstall/--dry-run/--force）
provider/	npm 可安装的 provider bundle（声明 dsh.bundle；prepack 把双语言版嵌入 pack/；language: zh|en）；经 ctx.effect() 注册技能提供方与 plugin_vet 门禁工具，skillsDir 配错响亮失败
provider/src/vet/	零依赖 plugin_vet 扫描引擎（许可证 / SBOM / commit 锁定 / 恶意模式 / 风险报告）
package.json	根 bundle manifest：声明 dsh.bundle.patch（→ provider/cordis.patch.yml）与 dshWorkshop intake 事实
verify/verify-skill-pack.mts	官方解析器 + 真实 skill 工具 + 真实工具运行时 headless 校验——双语共 25 项检查
VERSION	版本单一来源；每个 SKILL.md 的 metadata.version 与 provider/package.json 必须与其一致（CI 强制）
docs/	生态冲突检查、发布清单、改进计划与 plugin_vet 演示
CHANGELOG.md / SECURITY.md / CONTRIBUTING.md	发布历史、漏洞报告政策、贡献与校验规则
.github/workflows/verify.yml	CI：25 项校验 + 安装器演练 + provider 独立构建/打包冒烟（Ubuntu 与 Windows）
.github/dependabot.yml	provider 与 GitHub Actions 的每周依赖更新
LICENSE	Apache License 2.0

Configuration

所有可调项都是 Schemastery Config 字段（可从 cordis.yml 覆盖）。provider/cordis.patch.yml 逐键内联注释。

键	默认值	含义
language	zh	发布的语言版：中文 skills/ 或英文 skills-en/；设置 skillsDir 后忽略
watch	false	是否监听打包技能目录（内容静态，故默认关闭）
skillsDir	(未设置)	显式技能根目录；覆盖 language 推导的默认值，须含 <skill>/SKILL.md 技能
vet.enable	true	注册 plugin_vet 门禁工具
vet.timeoutMs	15000	tarball 下载超时（毫秒）
vet.maxFiles	800	扫描文件数上限
vet.maxFileBytes	262144	单文件字节上限
vet.maxExtractBytes	67108864	解压字节上限
vet.maxDepNodes	600	依赖树节点上限
vet.maxFindingsPerCheck	12	每项检查的发现数上限
vet.userAgent	dsh-skill-pack-security/2.0.0 (+https://github.com/PerryLink/dsh-skill-pack-security)	下载用的 user-agent
vet.gate.policy	warn	安装门禁：warn（不阻断）或 deny（FAIL 时阻断）

Tools & surfaces

表面	类型	说明
plugin_vet	tool	安装前供应链扫描（许可证 / SBOM / commit 锁定 / 恶意 / 风险卡片）；发现引用技能章节
skill-pack-security	skill provider	把本包的 skills/ 或 skills-en/ 版本注册到 ctx.skills
八个 SKILL.md 技能	skills	审计方法论，两个语言版
安装门禁	gate	vet.gate.policy: warn | deny 决定安装是否放行

Permissions & data

• 权限：dshWorkshop manifest 声明 files:read 与 network:fetch。
• 数据：plugin_vet 一次性下载 tarball（遵守超时与 AbortSignal），报告会打码密钥形态文本；插件不注入任何 prompt 段。

Security boundaries

• 零依赖引擎。 plugin_vet 只用 node: 内置与相对导入。
• 窄范围安装前门禁。 不是通用安全审计工具——刻意与扫描器插件、官方 dsh-plugin-check 契约校验器互补。
• 默认不阻断。 安装门禁默认为 warn，除非显式选择 deny。
• 内容原创。 与 Claude Code 技能格式兼容，但不复制 CC 技能内容、不设技能市场。

Verification

verify/verify-skill-pack.mts 从本机 deepseek-harness checkout 导入官方 dsh-skill-filesystem 解析器、真实 skill 工具与真实工具运行时，对两个语言版实测 25 项检查：

1. 目录结构：两个语言版齐备、各 8 个 bundle、无多余平铺 md、frontmatter name 与目录名一致、≤ 300 行、references/ 已接线、metadata.version 与 VERSION 文件同步
2. 与官方 .agents/skills/ 技能（运行时从 checkout 推导）及已知社区技能包零重名 3–6. 每个语言版（中文 skills/、英文 skills-en/）：官方 provider 发现全部 8 个技能、ctx.skills.get() 加载全部正文、真实 skill 工具返回 <skill_content>（未知名/非法名被拒绝）、会话目录只含 name+description——whenToUse 不进入模型目录（官方设计）
3. 13 个坏 frontmatter 用例逐条验证官方 fail-closed 规则（缺字段、驼峰遗留键、非布尔值、非 kebab 名、嵌套目录、名称不一致）；平铺技能可发现，嵌套 **/SKILL.md 不被发现
4. 可选 provider 插件经 ctx.effect() 挂载中文版与英文版、dispose 干净，并拒绝错误配置（空/不存在的 skillsDir） 9–15. 自加固检查：zh↔en 结构对齐、references 接线（无悬空/孤儿文件）、provider 版本同步、文档 rank 对照官方常量、grep -E 模式 POSIX 可移植、包内密钥自检、release-checklist UTF-8 安全 16–19. plugin_vet 走真实工具运行时：注册到 ctx.tools；合规 fixture 通过；无 license fixture 失败并引用 dependency-audit §3；恶意 postinstall fixture 失败（脚本/回传/混淆，引用 supply-chain-review §1）；policy: deny 下门禁阻断安装
5. 扫描引擎零依赖（仅 node: 内置与相对导入）
6. 报告脱敏：密钥形态文本不进入渲染输出

# 本地运行：默认自动解析包旁的 harness checkout，也可显式指定
$env:DSH_HARNESS_CHECKOUT = 'D:\deepseek-harness'
& D:\deepseek-harness\node_modules\.bin\tsx.CMD verify\verify-skill-pack.mts
# All 25 checks passed for dsh-skill-pack-security.

同样的 25 项检查由 .github/workflows/verify.yml 在 GitHub 上每次 push 自动重跑——Ubuntu 与 Windows 双平台——另有 install.sh/install.ps1 演练与 provider 独立构建/打包冒烟（断言 tarball 含双语言版与 bundle patch）。

Known limitations

• 不是完整审计工具。 plugin_vet 是窄范围的安装前信任门禁，不能端到端取代人工审计。
• 仅静态扫描。 恶意模式与维护状态信号是对发布包的启发式判断，不是动态分析。
• 每根目录一个语言版。 同名技能在同一根目录内按 rank 去重，只有一个语言版进入会话目录。

Roadmap

• dsh-skill-pack-data-engineering —— 数据管道、数据质量、ETL 检查清单（同模板）
• dsh-skill-pack-oss-collab —— PR 礼仪、issue 分类、维护者工作流
• dsh-skill-pack-performance —— profile 方法论、基准判定、回归清单
• 本包内更多技能（保持纯技能边界）：sbom-lifecycle（SBOM 生成/老化/导入工作流）、pen-test-review（授权测试的范围界定与报告评审）、compliance-audit（ASVS/NIST-CSF 走查）
• 随每次发布刷新 plugin_vet 演示产物（docs/demos/run-demos.mjs），并随官方校验器新增检测保持 dsh-plugin-check 互补表准确

Development

pnpm --dir provider run typecheck   # tsc --noEmit
pnpm --dir provider run build       # tsc --noEmitOnError
pnpm --dir provider run prepack     # 把两个语言版嵌入 tarball
tsx verify/verify-skill-pack.mts    # 25 项 headless 校验

Topics

dsh, dsh-plugin, deepseek-harness, skill-pack, skills, security, security-audit, supply-chain, supply-chain-security, prompt-injection

Contributors

• @PerryLink —— 作者与维护者：双语版八个技能、安装脚本、验证套件、provider 包、CI 与文档。

PerryLink DSH Plugin Family

本项目是 PerryLink 维护的 DeepSeek Harness 插件之一。如果你觉得这个插件有用，其余的很可能同样有用：

插件	一句话说明
dsh-mask	PII 脱敏中间件：模型边界匿名化、展示层还原
dsh-mcp-panel	只读 MCP 运行时面板：/mcp 命令 + 设置页，状态/工具/错误一览
dsh-doublecheck	工程纪律守门：需求审讯、测试证据门、对抗评审
dsh-background-agents	持久化后台子代理：Web 侧边栏进度、随时留言与打断
dsh-lsp-actions	基于语言服务器的诊断/格式化/补全/代码动作/重命名
dsh-output-styles	对标 Claude Code outputStyles 的运行时风格切换
dsh-checkpoint-rewind	对标 Claude Code /rewind：快照、会话 fork、一键回退
dsh-permission-rules	Claude Code 风格声明式 allow/deny/ask 权限规则，带审计
dsh-auto-review	审批链上的第二模型自动审查，默认 fail-closed
dsh-memento	带审批门的跨会话记忆：ctx.memory + SQLite + memory 工具
dsh-skill-pack-security	安全审计技能包：密钥扫描、依赖与供应链审查
dsh-session-pin	在 Web 侧边栏置顶会话，持久排序
dsh-composer-history	Web 作曲器终端式输入历史：方向键、Ctrl+R 搜索
dsh-github	DSH 的 GitHub PR/issue 集成，所有写操作经审批门
dsh-plugin-guide	插件开发知识库，随 bundle 安装的按需 agent 技能
dsh-claude-move	把 Claude Code 会话、记忆、技能和 CLAUDE.md 迁入 DSH

License

Apache License 2.0 © 2026 dsh-skill-pack-security contributors