1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | Azure Confidential Ledger Skill(azure-confidential-ledger) |
| 作者/维护者 | Microsoft(MicrosoftDocs/Agent-Skills 仓库,微软官方文档团队维护) |
| 来源链接 | https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/azure-confidential-ledger |
| 许可证 | 文档内容 CC BY 4.0、代码部分 MIT(数据来源:GitHub API license 字段 + 仓库 LICENSE-CODE 文件) |
| GitHub Stars | 725(数据来源:GitHub API;该数字属整个 Agent-Skills 合集仓库,不代表本技能自身热度) |
| Forks | 117(同上,合集整体数据) |
| 最新版本 | 仓库不发布正式 release,内容随 Microsoft Learn 文档源自动化再生成;本技能文件最近一次生成时间为 2026-07-12(数据来源:SKILL.md 内 generated_at 元数据 + GitHub commits API) |
| 安装方式 | Claude Code / Codex 可通过官方插件市场一键安装整套技能集,或手动复制 skills/azure-confidential-ledger/ 目录到本地 agent 的 skills 目录 |
2. 功能介绍与亮点
这是微软官方把 Azure Confidential Ledger(基于机密计算 SGX 飞地的不可篡改分布式账本服务)的 Microsoft Learn 文档预编译成的结构化参考技能,SKILL.md 正文按五大主题组织,均带精确行号索引或文档直链:
- 五大主题全覆盖:故障排查、决策辅助、安全、集成与编码模式、部署,覆盖从选型到生产部署的完整生命周期。
- 安全与身份一节内容最丰富:9 条独立文档链接,覆盖 Entra ID 认证配置、应用注册、基于证书/令牌两类用户与角色管理、节点认证凭证校验等账本可信基础。
- 集成场景具体到代码模式:Blob Storage 摘要写入、Power Automate + Cosmos DB 联动、账本数据组织方式、MST(Microsoft Signing Transparency)载荷设计、JavaScript 用户自定义函数编写,均给出对应官方文档链接。
- 明确的技能边界声明:description 中显式注明不适用于 Azure Confidential Computing、Azure Key Vault、Azure Dedicated HSM、Azure Payment HSM,并指路到同仓库对应姊妹技能。
- 无本地代码执行:技能目录内仅含一份 Markdown 文件,不含任何脚本或可执行文件。
亮点:微软官方出品、内容完全溯源到 learn.microsoft.com 权威文档;覆盖从 Managed CCF 迁移到 Azure Confidential Ledger 的路径指引,属于该服务近期活跃演进的知识点。
3. 适用场景
固定分类:安全与合规。
适用于需要不可篡改审计日志、合规溯源或防篡改数据存证的团队——无论是为医疗、金融、供应链等场景设计防篡改记录方案的架构师,还是需要排查 MST 签名验证问题、配置 Entra 认证与证书用户、或把账本数据与 Blob Storage/Cosmos DB/Power Automate 打通的后端开发者,都可以让 agent 按需调取该技能获取官方权威指导。该服务本身是标准 Azure 订阅下即可开通的托管服务,不需要额外专用硬件采购,比依赖专用硬件的 HSM 类技能受众更宽。
4. 跨 Agent 兼容性
- Claude Code:原生支持——仓库提供
.claude-plugin/插件清单,/plugin marketplace add MicrosoftDocs/agent-skills后执行/plugin install azure-agent-skills@microsoft-agent-skills即可安装整套技能(含本技能)。 - Codex:需适配——仓库同时提供
.codex-plugin/marketplace catalog、README 明确将 Codex CLI 列入声明兼容的 agent 名单,理论上可用同样的插件市场流程安装;但专门核验发现 Codex CLI 默认沙箱不带网络访问、web_search默认为缓存模式而非实时抓取,本技能运行时需要联网拉取 Learn 文档正文,故需要用户额外开启network access/live网络权限后才能完整发挥作用。 - OpenClaw:需适配——OpenClaw 读取与 Claude Code 相同的 SKILL.md 标准,且专门核验确认其内置
web_fetch工具可满足本技能的联网抓取需求;但仓库 README 未列出该 agent 的专门安装说明,需手动完成目录复制。 - Hermes Agent:需适配——Hermes 官方技能系统原生支持 SKILL.md 标准,且专门核验确认其内置 Web 搜索与浏览器工具可满足联网抓取需求;但仓库 README 未将 Hermes 列入声明兼容的 agent 名单,需手动完成目录复制。
5. 推荐理由
不可篡改审计日志类需求几乎每个受监管行业都会遇到,但 Azure Confidential Ledger 本身的落地门槛集中在认证与集成两端——Entra ID 与证书两条用户体系并存、MST 载荷与 Claim 设计缺乏统一范式、与 Blob/Cosmos DB/Power Automate 的联动方式分散在多篇文档里。这个技能把这些内容预编译成带行号的结构化索引,安全一节尤为详尽(9 条独立文档),且明确标注了与三个姊妹 HSM/机密计算技能的边界,避免 agent 误用;相比要求企业采购专用硬件、受众集中在有专项预算的大型组织的 HSM 类技能,本技能依托的是标准 Azure 订阅即可开通的托管服务,覆盖更广的合规存证场景。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 发布方 MicrosoftDocs 系微软官方文档团队、内容对象为微软自有产品 Azure Confidential Ledger,属第一方官方出品;所属 Agent-Skills 合集仓库 725 星不计入单个子技能;专门检索未找到针对 azure-confidential-ledger 这一具体子技能的独立第三方评价或讨论 |
| 可用性 | 9 | 内容结构完整,五大主题均有实质内容并带行号索引与官方文档直链(安全一节 9 条链接,覆盖认证、证书/令牌用户与角色管理、节点凭证校验等全流程);仓库该路径最近一次生成距今约 7 周,处于持续自动化再生成状态;插件市场一键安装或手动复制单文件均简便,无付费依赖;运行时需联网抓取 Learn 文档内容,非完全自包含 |
| 安全性 | 9 | 官方出品、完全开源可审计(文档 CC BY 4.0、代码 MIT);技能目录内无任何脚本或可执行文件,仅一份 Markdown;全文逐段检查未发现任何要求 agent 顺带提及第三方品牌或执行任务外操作的可疑指令;运行时唯一的“外联”是拉取 learn.microsoft.com 官方文档页面,目标完全透明;技能本身只提供配置指导,不代 agent 存储或操作实际凭据 |
安全检查清单:
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行范围 | 无——技能目录内不含任何脚本或可执行文件 |
| ② 运行时联网外发 | 需要网络访问以拉取文档内容,目标固定为 learn.microsoft.com 官方页面,外联目标透明 |
| ③ API key/凭据 | 不涉及,技能本身不需要任何凭据,也不代用户存储或传输实际密钥 |
| ④ 可疑指令/注入迹象 | 未发现——全文逐段核查均为文档索引与链接列表 |
| ⑤ 作者/组织信誉 | 微软官方文档组织 MicrosoftDocs,无造假迹象;技能目录本身不含任何可执行代码 |
| ⑥ License | 文档 CC BY 4.0、代码 MIT,明确 |
| ⑦ 最近维护时间 | 本技能文件 2026-07-12 由自动化流水线生成,所属仓库持续同步 Learn 文档源 |
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与本技能的差异 |
|---|---|---|
| azure-key-vault(同合集内) | 同一仓库参考技能,聚焦密钥/密钥库的存储与访问控制 | Key Vault 解决的是“密钥怎么存、谁能访问”;本技能解决的是“一份数据记录如何被不可篡改地留存并可验证”,两者常配合但不替代 |
| azure-cloud-hsm / azure-dedicated-hsm / azure-payment-hsm(同合集内) | 同一仓库参考技能,聚焦专用硬件安全模块的部署与密钥生命周期管理 | 三支 HSM 技能都要求企业采购专用硬件集群,受众集中在有专项预算的大型组织;本技能依托标准 Azure 订阅即可开通的托管服务,无需额外硬件投入,适用场景更广泛 |
| AWS QLDB / Amazon Managed Blockchain(第三方产品,非 skill) | 云厂商专属的账本类托管服务 | 均为云厂商锁定的基础设施产品,而非可安装的 agent skill;本技能是把 Azure Confidential Ledger 官方文档预编译为 agent 可调用的参考知识,帮助工程师在 Azure 原生环境内完成同类账本配置工作 |
8. 用户评价
该技能所属 SKILL.md 索引本身在第三方渠道尚无具名用户评价;针对其索引的底层服务 Azure Confidential Ledger,GitHub 搜索未发现针对本子技能的独立第三方讨论帖或博客评测,MicrosoftDocs/Agent-Skills 仓库 issue 区亦未见与该子技能相关的具名反馈。
9. 其他补充
该仓库整体按 Compute、集成、数据与分析、AI/ML、安全与身份、网络、基础设施、管理、专项等类别组织了 200 余个同结构技能,覆盖 Azure 几乎全部主流服务;官方维护了一份 docs/BUNDLES.md 精选包清单,按场景打包常用技能组合。
10. 安装使用方式
- 插件市场(Claude Code):
/plugin marketplace add MicrosoftDocs/agent-skills,再执行/plugin install azure-agent-skills@microsoft-agent-skills,随后运行/reload-plugins或重启生效,将安装该仓库全部技能。 - 插件市场(Codex):
codex plugin marketplace add MicrosoftDocs/agent-skills,再从/plugins浏览器中选择安装azure-agent-skills;安装后需确认 Codex 的网络访问权限已开启(默认沙箱不联网),否则技能无法拉取文档正文。 - 手动安装(适用于 OpenClaw / Hermes Agent 等其他 agent):克隆仓库后,将
skills/azure-confidential-ledger/目录复制到本地 agent 的 skills 路径(如.claude/skills/、.hermes/skills/等,具体路径因 agent 而异)。 - 使用前无需额外认证或 API key;技能触发后会在需要时通过
mcp_microsoftdocs:microsoft_docs_fetch(如已安装 Microsoft Docs MCP)或普通网页抓取工具拉取具体文档内容。
11. 注意事项
- 技能内容为预编译的文档索引而非实时文档镜像,若
generated_at元数据显示的生成时间超过 3 个月,SKILL.md 会提示 agent 建议用户拉取仓库最新版本。 - 默认安装方式是整套插件(200 余个技能一次性安装),若只想安装
azure-confidential-ledger单个技能,需改用手动复制目录的方式。 - 跨 Agent 兼容性仅确认 Claude Code 原生支持;Codex 需手动开启网络访问权限,OpenClaw、Hermes Agent 均需手动复制目录完成适配。
- 技能明确声明不适用于 Azure Confidential Computing、Azure Key Vault、Azure Dedicated HSM、Azure Payment HSM,误用场景应改用仓库内对应的姊妹技能。
- 技能本身不执行任何本地代码,但依赖网络访问拉取 Microsoft Learn 页面,离线环境下只能使用 SKILL.md 内置的分类目录与直链列表,无法获取链接指向的具体文档正文。
- 使用 Azure Confidential Ledger 服务本身需要一个已配置的 Azure 订阅与账本实例,涉及按量计费成本。