mcpField
A
asc-testflight

asc-testflight

github.com/tddworks测试与质量586 次安装5 周前更新
代码仓库

关于 asc-testflight

asc-testflight 是用于管理 TestFlight 测试版群组和测试人员的命令行技能。响应中包含可直接运行的后续命令，并支持 CSV 导入和导出。

主要功能

  1. 01列出测试版群组和测试人员
  2. 02以 CSV 导入和导出测试人员
  3. 03使用建议的后续命令
  4. 04以 JSON、表格或 Markdown 输出

适用场景

  1. 01查找应用的测试版群组
  2. 02查看群组中的测试人员
  3. 03导入或导出测试人员列表

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/tddworks/asc-cli-skills --skill asc-testflight

安装后在 Claude Code 中输入/asc-testflight确认已加载。

附带文件references/commands.md

详细介绍

使用 asc 管理 TestFlight Beta 测试人员

管理 TestFlight 分发的 Beta 群组和测试人员。

身份验证

执行任何 TestFlight 命令前，请先设置凭据：

asc auth login --key-id <id> --issuer-id <id> --private-key-path ~/.asc/AuthKey.p8

CAEOAS — 后续步骤由可执行操作指引

每个 JSON 响应都包含 "affordances"，其中提供可直接运行的命令：

BetaGroup 可执行操作：

{
  "id": "g-abc123",
  "appId": "6450406024",
  "name": "External Beta",
  "affordances": {
    "listTesters":   "asc testflight testers list   --group-id g-abc123",
    "importTesters": "asc testflight testers import --group-id g-abc123 --file testers.csv",
    "exportTesters": "asc testflight testers export --group-id g-abc123"
  }
}

BetaTester 可执行操作：

{
  "id": "t-xyz789",
  "groupId": "g-abc123",
  "email": "[email protected]",
  "affordances": {
    "listSiblings": "asc testflight testers list   --group-id g-abc123",
    "remove":       "asc testflight testers remove --group-id g-abc123 --tester-id t-xyz789"
  }
}

直接复制可执行操作命令即可，无需查找 ID。

解析 App ID

请参阅 project-context.md — 在询问用户或运行 asc apps list 前，先检查 .asc/project.json。

典型工作流

APP_ID=$(cat .asc/project.json 2>/dev/null | jq -r '.appId // empty')
# If empty: ask user or run `asc apps list | jq -r '.data[0].id'`

# 1. Find beta groups for an app
asc testflight groups list --app-id "$APP_ID" --pretty

# 2. List testers in a group (copy affordance "listTesters" from step 1)
asc testflight testers list --group-id g-abc123 --pretty

# 3. Add a single tester
asc testflight testers add \
  --group-id g-abc123 \
  --email [email protected] \
  --first-name Jane \
  --last-name Doe

# 4. Remove a tester (copy affordance "remove" from tester JSON)
asc testflight testers remove --group-id g-abc123 --tester-id t-xyz789

# 5. Bulk import from CSV (header row required: email,firstName,lastName)
asc testflight testers import --group-id g-abc123 --file testers.csv

# 6. Export to CSV (pipe to file or use redirect)
asc testflight testers export --group-id g-abc123 > testers.csv

# 7. Clone a group's testers to a new group
asc testflight testers export --group-id g-abc123 > testers.csv
asc testflight testers import --group-id g-new456 --file testers.csv

CSV 格式

导入/导出 CSV — 必须包含标题行，firstName 和 lastName 为可选项：

email,firstName,lastName
[email protected],Jane,Doe
[email protected],John,Smith
[email protected],,

输出标志

--pretty          # Pretty-print JSON
--output table    # Table format
--output markdown # Markdown table

完整命令参考

所有标志、筛选器和示例，请参阅 commands.md。

评论

支持 Markdown