用途:在 CLI for Microsoft 365 仓库中,依据 GitHub issue 规格构建完整、可发布的 CLI 命令。若未提供 issue,应先向用户索取 issue URL 或规格,不可直接开工。
主要能力与产物:工作流按顺序执行,产出四类文件——命令实现、单元测试、文档页、侧边栏注册,最后对照 PR 检查清单验证。
阶段一 解析规格:从 issue 提取命令名、描述、服务/工作负载、选项(必选/可选、类型、别名、允许值、选项集)、API 端点、示例、响应结构;识别应继承的基类(如 SpoCommand、GraphCommand、GraphApplicationCommand、AzmgmtCommand);检查命令名中每个词是否在 eslint.config.mjs 字典中,缺失则按字母序补充。若规格缺少完整 API 端点、HTTP 方法、请求载荷或响应结构,必须询问用户,禁止臆造或类比推断。
阶段二 实现:创建 src/m365/<service>/commands/<noun>/<noun>-<verb>.ts,类名用 <Service><Noun><Verb>Command;选项用 z.strictObject 展开 globalOptionsZod.shape,别名用 .alias(),枚举用 zod.coercedEnum,校验用 .refine(),选项集实现 getRefinedSchema;只用 async/await;verbose 日志走 logger.logToStderr;错误用 this.handleRejectedODataJsonPromise(err);SPO 文件/文件夹端点用 GetFileByServerRelativePath / GetFolderByServerRelativePath;删除类命令需 force 选项与确认提示;不用 any、不留注释代码。随后在 src/m365/<service>/commands.ts 按字母序注册命令常量。
阶段三 测试:创建 <noun>-<verb>.spec.ts,覆盖名称、描述、每条校验的通过与失败、选项集组合、每个逻辑分支、API 错误;用 npm test 运行,新文件需达到 100% 语句、分支、函数与行覆盖。
阶段四 文档:创建 docs/docs/cmd/<service>/<noun>/<noun>-<verb>.mdx,含用法、选项、权限、示例与响应;可选参数用方括号,示例使用长选项名并以 m365 开头,数据脱敏(tenant → contoso),列表命令用 JSON 数组,无响应命令写明成功时不返回响应。最后在 docs/src/config/sidebars.ts 按字母序添加条目。
阶段五 验证:阅读 references/pr-checklist.md 逐项核对,运行 npm run build 与 npm test,确认新命令四项覆盖率均为 100% 后再视为完成。
限制:技能本身仅描述开发工作流,未提供收费、价格或平台信息;必须先有规格且 API 细节完整,否则应停止并询问。