skillsign

🔐 Agent Skill 加密签名验证工具

基于 ed25519 的 Agent Skill 加密签名工具,提供完整性校验与来源追溯能力,保障 Skill 分发安全可信。

收藏
5k
安装
2.1k
版本
v1.1.0
CLS 安全性认证2026-05-09
点击查看完整报告 >

使用说明

核心用法

skillsign 是一款专为 Agent Skill 文件夹设计的加密签名与验证工具,采用 ed25519 非对称加密算法和 SHA-256 哈希算法。用户通过 keygen 生成密钥对后,可使用 sign 命令对 Skill 文件夹进行签名——该过程会遍历文件夹内所有文件并计算哈希值,生成包含文件清单和数字签名的元数据,存储于 .skillsig// 目录中。接收方可通过 verify 命令验证文件完整性,检测篡改、新增或删除的文件。工具还提供 trust 信任管理、、chain 签名链追溯(isnād)以及 revoke 密钥吊销等完整功能。

显著优点

安全机制完善:采用业界标准的 ed25519 签名算法和 SHA-256 哈希,私钥文件权限严格设置为 0600,防止未授权访问。完整的签名链(isnād)支持多作者连续签名追溯,满足审计需求。

零网络依赖:纯本地工具,无任何网络访问代码,杜绝远程攻击面,适合离线环境和安全敏感场景。

依赖极简:仅依赖经过广泛审计的 cryptography 库,无其他第三方依赖,降低供应链攻击风险。

易用性高:单文件 Python 实现,命令行接口清晰直观,支持密钥生成、签名、验证、信任管理、吊销等完整工作流。

潜在缺点与局限性

无中心化时间戳:签名时间戳为本地生成,非可信第三方时间源,存在时间伪造理论可能。

信任决策本地化:用户需自行判断公钥来源可信度,工具不提供中心化身份认证服务。

历史可重写风险:签名链不防止拥有私钥的恶意方重新签名并覆盖历史记录。

版本号不一致:SKILL.md 与 _meta.json 中版本号存在差异(1.0.0 vs 1.1.0),反映维护细节待完善。

适合的目标群体

  • Agent 平台开发者和运维人员,需保障 Skill 分发安全
  • 开源 Skill 作者,希望为作品提供可验证的来源证明
  • 企业安全团队,需对内部使用的 Agent Skill 进行完整性审计
  • 安全敏感场景用户,需在运行第三方 Skill 前验证其未被篡改

使用风险

密钥管理风险:私钥泄露将导致攻击者可伪造签名,用户需妥善保护 ~/.skillsign/keys// 目录。

性能考量:大型 Skill 文件夹的哈希计算和签名验证可能产生 I/O 开销,建议定期而非实时验证。

依赖维护:需关注 cryptography 库的安全更新,及时升级以修复潜在漏洞。

误信风险:用户可能错误信任未经验证的公钥,建议通过多渠道交叉验证作者身份。

安全解读

核心用法

skillsign 是一款基于 ed25519 加密算法的 CLI 工具,专为 Agent Skill 文件夹提供签名、验证与溯源功能。用户通过 keygen 生成密钥对,sign 对技能文件夹进行签名(生成包含所有文件 SHA-256 哈希的清单并签名),verify 验证文件完整性与签名有效性,trust 管理可信作者公钥,chain 查看完整的签名历史溯源链(isnād)。

显著优点

  • 安全设计优秀:采用 ed25519 现代加密算法,私钥本地存储,无网络传输风险
  • 功能完整:覆盖密钥生成、签名、验证、信任管理、溯源链五大核心场景
  • 零网络依赖:所有操作纯本地完成,无 API 外调,杜绝数据泄露
  • 依赖极简:仅依赖 Python cryptography 库(>=41.0.0),该库为业界标准安全库
  • 溯源清晰:独创 isnād 概念,支持多作者签名历史追踪,适合供应链审计

潜在缺点与局限性

  • T3 来源可信度:作者为个人开发者(felmonfekadu),无企业背书,需人工审查后使用
  • 功能单一:专注于文件完整性校验,不支持代码行为分析或沙箱执行保护
  • 信任机制局限:依赖本地手动管理公钥,无去中心化或机构背书信任网络
  • 私钥管理责任:用户需自行保障 .pem 私钥文件安全,无硬件密钥或托管选项

适合人群

  • 需要分发 Skill 并建立作者可信度的开发者
  • 运行第三方 Skill 前需验证完整性的安全敏感用户
  • 关注代码供应链溯源(provenance)的 Agent 运维人员
  • 个人或小团队构建内部 Skill 信任体系的场景

常规风险

1. 来源风险:个人开发者账号可能被劫持,建议 fork 后自行维护关键版本
2. 密钥泄露风险:私钥文件若被复制,攻击者可伪造签名,需严格文件权限管理

3. 社会工程风险:攻击者可能分发伪造公钥,用户需通过可信渠道获取作者公钥

4. 功能边界风险:工具仅能验证文件未被篡改,无法保证代码本身无恶意逻辑

skillsign 内容

手动下载zip · 9.4 kB
README.mdtext/markdown
请选择文件