| name | tapd-base |
| description | TAPD 基础技能，包含 OAuth 授权、token 缓存、配置加载和通用 TAPD 用户态 API 调用。需要获取或复用 TAPD 用户态 token，或其它 TAPD skills 要求先授权时使用。 |
TAPD 基础用户态能力
使用这个 skill 处理 TAPD 用户态 OAuth、配置检查、token 缓存和通用 API 调用。它是 TAPD skills 的基础技能，tapd-story 和 tapd-testx 都依赖本目录下的 scripts。
串联方式
- 只做授权或通用 API：使用
tapd-base
- 操作需求：先使用
tapd-base 确认 token，再使用 tapd-story
- 操作 TestX：先使用
tapd-base 确认 token，再使用 tapd-testx
- 从需求生成或关联 TestX 用例：按
tapd-base -> tapd-story -> tapd-testx 串联
强制配置检查
命令示例默认已设置 skills 根目录。Codex 全局安装通常是 ~/.codex/skills，Claude Code 全局安装通常是 ~/.claude/skills：
export TAPD_SKILLS_ROOT="${TAPD_SKILLS_ROOT:-$HOME/.codex/skills}"
执行 OAuth 或 TAPD API 前，先检查 TAPD_CLIENT_ID 和 TAPD_CLIENT_SECRET：
python3 "$TAPD_SKILLS_ROOT/tapd-base/scripts/tapd_user_oauth_demo.py" check-config
如果任一为空、缺失或仍是占位值，停止后续 TAPD 操作，并提醒用户先配置凭据。
配置
推荐把真实配置放在 skill 目录外。
Codex：
mkdir -p ~/.codex/config
cp "$TAPD_SKILLS_ROOT/tapd-base/env.example" ~/.codex/config/tapd-base.env
Claude Code：
mkdir -p ~/.claude/config
cp "$TAPD_SKILLS_ROOT/tapd-base/env.example" ~/.claude/config/tapd-base.env
至少填写：
TAPD_CLIENT_ID=your_client_id
TAPD_CLIENT_SECRET=your_client_secret
脚本默认按这个顺序找配置：
TAPD_ENV_FILE~/.codex/config/tapd-base.env~/.claude/config/tapd-base.env- 当前工作目录
.env
tapd-base/.env
默认 scope 是：
TAPD_SCOPES=user story#read story#write comment#read comment#write
默认 token cache：
~/.codex/memories/tapd-base/session.json
如果只存在 Claude Code 配置文件、没有 Codex 配置文件，默认使用：
~/.claude/tapd-base/session.json
OAuth 流程
启动本地回调授权：
python3 "$TAPD_SKILLS_ROOT/tapd-base/scripts/tapd_user_oauth_demo.py" authorize
直接打开默认浏览器：
python3 "$TAPD_SKILLS_ROOT/tapd-base/scripts/tapd_user_oauth_demo.py" authorize --open
只打印授权 URL：
python3 "$TAPD_SKILLS_ROOT/tapd-base/scripts/tapd_user_oauth_demo.py" show-url
已有 TAPD 回跳 code 时直接换 token：
python3 "$TAPD_SKILLS_ROOT/tapd-base/scripts/tapd_user_oauth_demo.py" exchange-code \
--code your_callback_code \
--workspace-id 32131908
通用 API 调用
用缓存 token 调用户态 API：
python3 "$TAPD_SKILLS_ROOT/tapd-base/scripts/tapd_user_api.py" /users/info
调用任意 TAPD 用户态 API：
python3 "$TAPD_SKILLS_ROOT/tapd-base/scripts/tapd_user_api.py" \
/api/testx/case/v1/namespaces/32131908/repos \
--query Offset=0 \
--query Limit=20
维护注意事项
- TAPD 回调里会带
code、state、resource
- TAPD 文档说明
code 有效期 5 分钟
- 当前缓存的 token 只用于用户态 TAPD API
- 不提交真实
.env、token cache 或凭据
