SuperAPI AI 工具集

github-script

编程与开发

查看项目

更新于 10-16 05:48

技能介绍

用途:为 GitHub Actions 中由 actions/github-script@v8 执行的 JavaScript 提供最佳实践指南,帮助编写更健壮的脚本。

主要能力与要点:该 action 全局提供 @actions/core 与 @actions/github 包,因此不要为 @actions/core 添加 import 或 require。日志应使用 core.info、core.warning、core.error,而非 console.log 或 console.error;用 core.setOutput 设置 action 输出;用 core.exportVariable 为后续步骤设置环境变量;用 core.getInput 获取输入,并用 required: true 标记必填项;用 core.setFailed 以错误信息将 action 标记为失败。

步骤摘要:使用 core.summary.* 写入步骤摘要文件,用 core.summary.addRaw() 添加原始 Markdown(支持 GitHub Flavored Markdown),并调用 core.summary.write() 刷新待写入内容;摘要调用可链式,例如 core.summary.addRaw(...).addRaw(...).write()。

常见错误处理:尽量避免 any 类型,改用具体类型或 unknown;在 catch 中先判断 error 是否为 Error 实例再访问 message:catch (error) { core.setFailed(error instanceof Error ? error : String(error)); } 注意 core.setFailed 也会调用 core.error,因此不要同时调用两者。

类型检查与格式:运行 make js 执行 TypeScript 编译器;运行 make lint-cjs 检查文件;编辑后运行 make fmt-cjs 格式化文件。

限制:以上仅为该技能文本中明确给出的规范与命令,其余平台、收费或效果信息暂未提供。