Agent Skills: ATL CLI

ATL CLI

atl
├── init                              # Setup config
├── issue (jira)
│   ├── list (ls, search) [text]      # -t -s[] -y -a -r -e -C -l[] -p -q --order-by --reverse --limit
│   ├── view [key]
│   ├── comment [key] [text]
│   ├── comments [key]
│   ├── transition [key] [name?]      # Omit name to list available
│   └── prs [key]                     # Linked pull requests
├── page (confluence)
│   ├── list [space]                  # --type --limit
│   ├── search (find, query) [text]   # -s -t --title --creator --contributor --created --modified -q --order-by --reverse --limit
│   ├── view [id]                     # --format --info -o --with-images --with-toc
│   ├── create                        # -s -t -c -f -p
│   ├── edit [id]                     # -t -c -f
│   ├── delete (rm, del) [id|title|url]  # -s --cascade -y
│   ├── children [id]                 # --limit
│   └── spaces                        # --limit
└── pr
    ├── list [proj/repo]              # --state --author --base --head --limit
    ├── view [proj/repo] [id]
    ├── diff [proj/repo] [id]
    ├── comment [proj/repo] [id] [text]
    ├── merge [proj/repo] [id]        # --force --delete-branch
    └── status                        # Your PRs & reviews

Global: --config, --username

Jira Issue List

atl issue list -a me -t Bug -s Open   # My open bugs
atl issue list -s '~Done' -e 123      # Not Done, epic auto-prefixed
atl issue list -q "created >= -7d"    # Raw JQL

| Flag | Values | |------|--------| | -t | Bug, Story, Task, Epic | | -s | Status (multi, ~ negates) | | -y | Blocker, Critical, Major, Minor, Trivial | | -a | me, none, x, username | | -e | Epic key (auto-prefixes project) | | --order-by | created, updated, priority, status, key, assignee, reporter, summary |

Confluence Page Search

atl page search "notes" -s '~john.doe'
atl page search --title "CLI" --creator john.doe --modified month
atl page search -q 'type=page AND title~"API"'

| Flag | Values | |------|--------| | -t | page, blogpost, comment, attachment | | --modified | today, yesterday, week, month, year | | --order-by | created, lastmodified, title |

Confluence Page View/Create/Edit

atl page view 12345 --format storage -o page.html  # Fetch before edit
atl page create -s SPACE -t "Title" -f content.html -p "Parent"
atl page edit 12345 -f updated.html
atl page delete 12345 --cascade -y

-p/--parent: ID, title (needs space), or URL

Bitbucket PR

atl pr list PROJ/repo --state ALL --author @me
atl pr merge PROJ/repo 140 --force --delete-branch
atl pr status

| --state | OPEN, MERGED, DECLINED, ALL |

Pitfalls

# Quote tilde - shell expansion
atl page list '~john.doe'      # RIGHT
atl page list ~john.doe        # WRONG

# Positional arg, not --space
atl page list '~john.doe'      # RIGHT
atl page list --space SPACE    # WRONG

# No CDATA in Confluence storage
<pre>code</pre>                # RIGHT
<![CDATA[code]]>               # WRONG

Read references/confluence-guidelines.md before editing pages.