SuperAPI AI 工具集

create-github-action-workflow-specification

办公与效率

查看项目

更新于 10-16 05:49

技能介绍

用途:为已有的 GitHub Actions 工作流编写正式规格说明,描述其行为、需求与约束,作为文档与后续更新的模板。规格需实现无关,聚焦工作流“做什么”而非“怎么做”。

主要能力:提供完整规格模板,含工作流概览、执行流程图(Mermaid)、作业与依赖表、需求矩阵(功能/安全/性能)、输入输出契约、密钥与变量、执行约束、错误处理策略、质量门、监控与告警、集成点、合规治理、边界场景、验证标准、变更管理与版本历史。

使用方式:针对 ${input:WorkflowFile} 分析工作流文件,按步骤提取核心目的、映射作业依赖、识别契约、捕获约束、定义质量门、记录错误路径、抽象实现细节。结果保存为 /spec/spec-process-cicd-[workflow-name].md。

AI 优化要求:令牌高效、结构化数据(表格/列表/图)、术语一致、避免具体语法与工具版本、便于维护。Mermaid 支持顺序、并行、条件流程,5 个以上作业建议用 subgraph。

适用场景:CI/CD 工作流文档化、AI 辅助维护、变更前规格先行、审计与合规记录。

限制:资料未提供具体安装命令、收费、平台支持范围或实际效果数据;模板中的占位符需按实际工作流填写。