Skip to content

Commit 7b0e26b

Browse files
committed
refactor(skills): split ado-cli command reference into topic files
The ado-cli SKILL.md was a 540-line monolith. Split the Full command reference into 7 topic-focused reference files under references/: projects-teams-users.md, repos.md, workitems.md, prs.md, pipelines.md, artifacts.md, admin.md SKILL.md is now 284 lines: overview, decision tree, quick-start, global options, and a reference file index with a table mapping each area to its file. Reference files are readable via: ado skills read ado-cli/references/prs.md Also cleaned up stale content: - ado-auth: removed 4 historical bug-fix rows (v0.4.2/v0.4.3 fixes) - ado-ci: replaced version-pinned download URLs (ado-0.4.3-*) with version-agnostic latest release URLs
1 parent ae35621 commit 7b0e26b

10 files changed

Lines changed: 398 additions & 313 deletions

File tree

priv/skills/ado-auth/SKILL.md

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -166,10 +166,6 @@ ado <command> # uses saved config
166166
| `Identity not materialized` | New MSA org, user never visited in browser | Visit `https://dev.azure.com/{org}` once, then re-login |
167167
| `Organization not found` | Wrong org name | Check spelling; `ado whoami` to verify |
168168
| Browser OAuth times out | Firewall/Zscaler blocks | Use PAT or device code instead |
169-
| Device code login crashes with `WithClauseError` | API response uses `verification_url` (not `_uri`) | Fixed in v0.4.2+ |
170-
| Device code login prints garbled text | `CLI.color` returns IO list | Fixed in v0.4.2+ |
171-
| `connectionData` returns 400 with `api-version=7.1` | Some orgs reject versioned calls | Fixed in v0.4.2+ — now calls without version |
172-
| `Cannot record a vote for someone else` | PR created by someone else, user not in reviewer list | Fixed in v0.4.3 — CLI uses `current_user_id()` instead of `createdBy.id` |
173169

174170
## Security
175171

priv/skills/ado-ci/SKILL.md

Lines changed: 6 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -66,24 +66,18 @@ ado projects list
6666
## Downloading the binary
6767

6868
```bash
69-
# macOS arm64 (Apple Silicon)
70-
curl -L -o ado https://github.com/gilbertwong96/ado_cli/releases/latest/download/ado-0.4.3-macos-aarch64
71-
chmod +x ado && sudo mv ado /usr/local/bin/
69+
# Download the latest release binary (check the releases page for exact filenames):
70+
# https://github.com/gilbertwong96/ado_cli/releases/latest
7271

7372
# Linux x86_64
74-
curl -L -o ado https://github.com/gilbertwong96/ado_cli/releases/latest/download/ado-0.4.3-linux-x86_64
73+
curl -L -o ado https://github.com/gilbertwong96/ado_cli/releases/latest/download/ado-linux-x86_64
7574
chmod +x ado && sudo mv ado /usr/local/bin/
7675

77-
# Linux aarch64 (ARM servers, Raspberry Pi 4/5)
78-
curl -L -o ado https://github.com/gilbertwong96/ado_cli/releases/latest/download/ado-0.4.3-linux-aarch64
76+
# macOS arm64 (Apple Silicon)
77+
curl -L -o ado https://github.com/gilbertwong96/ado_cli/releases/latest/download/ado-macos-aarch64
7978
chmod +x ado && sudo mv ado /usr/local/bin/
8079

81-
# macOS x86_64 (Intel)
82-
curl -L -o ado https://github.com/gilbertwong96/ado_cli/releases/latest/download/ado-0.4.3-macos-x86_64
83-
84-
# Windows x86_64
85-
# Download from https://github.com/gilbertwong96/ado_cli/releases/latest
86-
# ado-0.4.3-windows-x86_64.exe
80+
# Or install via npm: npm install -g @gilbertwong1996/ado
8781
```
8882

8983
Or install via npm: `npm install -g @gilbertwong1996/ado`

0 commit comments

Comments
 (0)