asc-skills

asc skills

从 tddworks/asc-cli-skills 仓库浏览、安装和管理 Claude Code Agent 技能。技能可为你的 Agent 提供 App Store Connect 工作流方面的专业知识，包括截图、TestFlight、代码签名、订阅等。

命令

list — 显示仓库中可用的技能

asc skills list

列出可从 tddworks/asc-cli-skills 安装的所有技能。此命令会委托执行 npx skills add tddworks/asc-cli-skills --list。

install — 将技能安装到你的 Agent 中

asc skills install --name asc-cli        # install a specific skill
asc skills install --all                 # install all available skills
asc skills install                       # same as --all (default)

此命令会委托执行 npx --yes skills add tddworks/asc-cli-skills。技能会安装到 ~/.claude/skills/。

标志	用途
--name <name>	按名称安装指定技能
--all	安装所有可用技能

installed — 显示本地已安装的技能

asc skills installed [--pretty]

读取 ~/.claude/skills/，解析每个技能的 SKILL.md frontmatter，并返回包含 CAEOAS 操作项的结构化 JSON。

uninstall — 移除已安装的技能

asc skills uninstall --name <name>

从 ~/.claude/skills/ 移除技能目录。

check — 检查技能更新

asc skills check

此命令会委托执行 npx skills check。返回以下结果之一：

• “所有技能均为最新版本。”
• “有可用的技能更新。运行 'asc skills update' 以刷新已安装的技能。”
• “Skills CLI 不可用。请使用以下命令安装：npm install -g skills”

update — 更新已安装的技能

asc skills update

此命令会委托执行 npx skills update，以获取最新版本。

典型工作流

# First time: install all asc skills
asc skills install --all

# Browse what's available
asc skills list

# Check what you have
asc skills installed --pretty

# Periodically check for updates
asc skills check

# Update when available
asc skills update

# Remove a skill you don't need
asc skills uninstall --name asc-game-center

自动更新检查器

每次运行 asc 命令时，都会自动执行非阻塞式更新检查。它不会中断正常的 CLI 流程——检查失败时会静默忽略。

防护规则（命中任一项时跳过检查）

条件	操作
设置了 ASC_SKIP_SKILL_CHECK=true 环境变量	跳过
设置了 CI 或 CONTINUOUS_INTEGRATION 环境变量	跳过
距上次检查不足 24 小时	跳过

工作原理

1. 运行 npx skills check（被动检查时使用离线模式）
2. 解析 stdout：查找 “update(s) available” 与 “up to date” / “no update”
3. 如果发现更新 → 向 stderr 输出提示：Skill updates available. Run 'asc skills update' to refresh installed skills.
4. 将 skillsCheckedAt 时间戳保存到 ~/.asc/skills-config.json

仅在成功时才会保存时间戳——如果 Skills CLI 不可用，则会在下次重试。

JSON 输出

asc skills installed --pretty

{
  "data": [
    {
      "affordances": {
        "listSkills": "asc skills list",
        "uninstall": "asc skills uninstall --name asc-cli"
      },
      "description": "App Store Connect CLI skill",
      "id": "asc-cli",
      "isInstalled": true,
      "name": "asc-cli"
    }
  ]
}

已安装的技能会显示 uninstall 操作项；尚未安装的技能则会显示 install 操作项。

技能存储

~/.claude/skills/
├── asc-cli/
│   ├── SKILL.md
│   └── references/
├── asc-auth/
│   └── SKILL.md
└── asc-testflight/
    ├── SKILL.md
    └── references/

~/.asc/skills-config.json          ← auto-update checker state

禁用自动更新检查

export ASC_NO_UPDATE_CHECK=1   # any value, presence-based

另请参阅

• 完整功能文档：docs/features/skills.md
• 技能源代码仓库：tddworks/asc-cli-skills
• CAEOAS：遵循任意 asc skills installed 响应中的 affordances.listSkills