1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | typespec-api-operations-github-awesome-copilot(子技能 typespec-api-operations) |
| 作者/维护者 | 位于 github/awesome-copilot 合集(GitHub 官方社区合集),由社区贡献者提交 |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/typespec-api-operations |
| 许可证 | MIT(合集仓库) |
| GitHub Stars / Forks | 合集仓库 39,954 / 5,103(GitHub API);该数字属整个合集,不代表本技能自身热度 |
| 技能自身热度 | skills.sh 搜索接口显示 8,773 次安装(网页接口) |
| 最新版本 | 无独立版本号;SKILL.md 约 9 KB,最近一次改动 2026-02-19 |
| 安装方式 | npx skills add https://github.com/github/awesome-copilot --skill typespec-api-operations |
2. 功能介绍与亮点
为 Microsoft 365 Copilot 的 TypeSpec API 插件补充 REST 操作的编写指南,全部以可复制的代码块给出。
- 覆盖 GET(列表、查询参数、路径参数、带 Adaptive Card 展示)、POST、PATCH、DELETE 四类操作的标准写法
- 对写操作提供
@capabilities确认卡片模板,DELETE/PATCH 默认带二次确认 - 附一个完整的 CRUD 示例(服务声明、模型、五个操作),以及分页、Header 参数、统一错误响应等进阶写法
- 给出每类操作的测试提示词,以及参数命名、
@visibility、日期格式、路由约定等最佳实践 - 纯提示词文档,无脚本、无外联
3. 适用场景
分类:工程效率与代码质量。
- 已有一个 M365 Copilot TypeSpec 插件工程,要给后端 API 逐个加操作的开发者
- 想给写操作加上“执行前确认”卡片,避免 Copilot 误删误改数据
- 需要一份 TypeSpec 装饰器(
@route、@card、@capabilities)速查范例的人
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 标准 SKILL.md,正文无平台专属变量,放入 skills 目录即可 |
| Codex | 需适配 | 内容可用,但 Codex 不自动发现 ~/.codex/skills,需手动引用 |
| OpenClaw | 未验证 | 未找到实测记录 |
| Hermes Agent | 原生支持 | 格式符合 Agent Skills 规范,按路径扫描子目录即可发现 |
5. 推荐理由
TypeSpec 装饰器语法冷门,模型凭记忆写容易出错。本技能把 M365 Copilot 插件最常用的操作写法、确认卡片与卡片数据绑定都固化成范例,直接照抄改字段即可,写操作默认带确认也更安全。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 技能自身 8,773 次安装;合集仓库近 4 万 stars,但不计入本技能个体热度 |
| 可用性 | 6 | 一条命令安装、范例完整;但前提是已有 M365 Copilot TypeSpec 插件工程,不适用于其他场景;SKILL.md 自 2026-02 起未更新,无独立示例输出 |
| 安全性 | 9 | 纯提示词,无代码执行、无外联 |
安全检查清单:① 不执行 shell:无;② 不联网外发:无(范例里的 https://api.example.com 为占位);③ 无需 API key;④ 无可疑指令;⑤ 来源为 GitHub 官方社区合集;⑥ MIT 许可明确;⑦ 合集 2026-10-12 仍有提交,该技能本身近 8 个月未改动(内容偏静态,TypeSpec 装饰器后续若变更需自行核对)。
综合 = 三项均值 ≈ 7.33。
7. 跟同类 Skills 相比的优势
| 方案 | 定位 | 差异 |
|---|---|---|
| 本技能 | M365 Copilot TypeSpec 插件的“加操作”范例集 | 覆盖 CRUD、确认卡片、分页与错误模型,开箱即抄 |
| TypeSpec 官方文档 | 语言与 HTTP 库的通用参考 | 权威且全面,但不涉及 M365 Copilot 专有的 @card、@capabilities 确认用法 |
| 让 AI 凭记忆直接写 TypeSpec | 自由生成 | 灵活,但装饰器与卡片绑定语法容易写错,且不保证写操作带确认 |
| 同仓库的 Adaptive Card / MCP 插件类技能 | 卡片或 MCP 插件的专项指南 | 偏卡片模板或 MCP 通道,本技能聚焦 REST 操作的声明写法 |
核心差异:专注 M365 Copilot 插件的 REST 操作声明,写操作默认带确认;代价是适用面窄。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价;skills.sh 显示 8,773 次安装。
9. 其他补充
- 贡献方式:向 github/awesome-copilot 提 PR
10. 安装使用方式
npx skills add https://github.com/github/awesome-copilot --skill typespec-api-operations
安装后在 TypeSpec 插件工程里说“给这个 API 插件加一个 DELETE 操作并带确认卡片”之类的需求即可触发;无需重启,视客户端而定。
11. 注意事项
- 仅适用于 Microsoft 365 Copilot 的 TypeSpec API 插件;其他 TypeSpec 用途(通用 OpenAPI 生成等)参考价值有限
- 范例中的 URL、字段为占位,需替换为真实后端
- 装饰器语法可能随 M365 Copilot 工具链版本变化,落地前以官方文档核对