configure-reusable-workflows

/configure:reusable-workflows

将 Claude 驱动的可复用 GitHub Actions 工作流从 claude-plugins 安装到项目中。

何时使用此技能

在以下情况下使用此技能……	在以下情况下采用其他方法……
添加用于安全、质量或无障碍检查的 Claude 驱动可复用工作流	设置标准 CI/CD 工作流（使用 /configure:workflows）
安装 claude-plugins 中预先构建的工作流调用文件	从头编写自定义 GitHub Actions 工作流
通过 CI 自动进行 OWASP、密钥扫描或代码异味检测	配置本地安全扫描工具（使用 /configure:security）
在拉取请求流水线中添加 WCAG 无障碍检查	手动执行一次性无障碍审计
跨多个类别快速搭建一整套 Claude 驱动的 CI 检查	只需检查现有工作流是否合规

上下文

• 工作流目录：!find . -maxdepth 1 -type d -name \'.github/workflows\'
• 现有调用文件：!find . -path '*/.github/workflows/*' -maxdepth 3 -name 'claude-*'
• 软件包文件：!find . -maxdepth 1 \( -name 'package.json' -o -name 'pyproject.toml' -o -name 'Cargo.toml' -o -name 'go.mod' \) -print -quit
• TypeScript 文件：!find . -maxdepth 2 \( -name '*.ts' -o -name '*.tsx' \) -print -quit
• 组件文件：!find . -maxdepth 3 \( -name '*.jsx' -o -name '*.vue' -o -name '*.svelte' \) -print -quit

参数

从命令参数中解析：

• --all：安装所有工作流
• --security：仅安装安全工作流
• --quality：仅安装质量工作流
• --a11y：仅安装无障碍工作流
• --list：列出可用工作流，但不安装

可用工作流

安全

工作流	描述	文件
secrets	检测泄露的密钥和凭据	reusable-security-secrets.yml
owasp	OWASP Top 10 漏洞扫描	reusable-security-owasp.yml
deps	依赖项漏洞审计	reusable-security-deps.yml

质量

工作流	描述	文件
typescript	TypeScript 严格性分析	reusable-quality-typescript.yml
code-smell	代码异味检测	reusable-quality-code-smell.yml
async	Async/await 模式问题	reusable-quality-async.yml

无障碍

工作流	描述	文件
wcag	WCAG 2.1 合规性检查	reusable-a11y-wcag.yml
aria	ARIA 模式验证	reusable-a11y-aria.yml

执行

执行此可复用工作流安装流程：

第 1 步：检测当前状态

1. 检查是否存在 .github/workflows/ 目录（若不存在则创建）
2. 列出所有现有的 Claude 驱动工作流调用文件
3. 根据现有文件确定项目类型

第 2 步：选择工作流

如果未提供标志参数，请询问用户要安装哪些类别：

Available workflow categories:
  [1] Security (secrets, owasp, deps)
  [2] Quality (typescript, code-smell, async)
  [3] Accessibility (wcag, aria)
  [4] All workflows

Which categories? (comma-separated, e.g., 1,2):

如果设置了 --list，则输出上方的“可用工作流”表格并停止。

第 3 步：生成调用工作流

为每个选定的工作流在 .github/workflows/ 中创建一个调用文件。

文件名约定：claude-<category>-<name>.yml

示例：claude-security-secrets.yml

显示名称约定：工作流的 name: 遵循 <Domain>: <Action> [<target>] 格式（需加引号，因为 YAML 会将 : 视为键分隔符）。对于这些可复用调用文件，正确的域名是 Claude:。规范规则和当前启用的域名请参阅 .claude/rules/workflow-naming.md。示例：name: "Claude: Security secrets"。

使用调用工作流模板：

name: "Claude: <Action> <target>"

on:
  pull_request:
    branches: [main]
  workflow_dispatch:

permissions:
  contents: read
  pull-requests: write
  id-token: write

jobs:
  check:
    uses: laurigates/.github/.github/workflows/reusable-<category>-<name>.yml@main
    with:
      # Default inputs - customize as needed
      max-turns: 5
    secrets: inherit

各类别的完整调用工作流文件请参阅 REFERENCE.md。

第 4 步：提醒配置密钥

安装后，输出所需的密钥配置：

Required secret: CLAUDE_CODE_OAUTH_TOKEN

To configure:
1. Go to repository Settings > Secrets and variables > Actions
2. Add secret: CLAUDE_CODE_OAUTH_TOKEN
3. Value: Your Claude Code OAuth token

Get token from: https://console.anthropic.com/

自定义

安装后，用户可以自定义：

输入项	用途	示例
file-patterns	要扫描的文件	'src/**/*.ts'
max-turns	Claude 分析深度	3（快速）至 10（彻底）
fail-on-*	发现问题时阻止合并	true / false
wcag-level	无障碍标准	'A'、'AA'、'AAA'

安装后

1. 配置密钥：将 CLAUDE_CODE_OAUTH_TOKEN 添加到仓库密钥中
2. 自定义模式：编辑 file-patterns 以匹配项目结构
3. 调整触发条件：修改 paths 过滤器，以匹配相关文件类型
4. 手动测试：使用 workflow_dispatch 在 PR 触发前进行测试

Agentic 优化

上下文	命令
列出可用工作流	/configure:reusable-workflows --list
一次性安装所有工作流	/configure:reusable-workflows --all
仅安装安全工作流	/configure:reusable-workflows --security
仅安装质量工作流	/configure:reusable-workflows --quality
仅安装无障碍工作流	/configure:reusable-workflows --a11y
检查现有调用方	find .github/workflows -name 'claude-*' -type f

标志

标志	描述
--all	安装所有工作流
--security	仅安装安全工作流
--quality	仅安装质量工作流
--a11y	仅安装无障碍工作流
--list	列出可用工作流，但不安装

另请参阅

• /configure:workflows - 标准 CI/CD 工作流（容器、release-please）
• /configure:security - 安全工具配置
• ci-workflows 技能 - 工作流模式