Public Access

Files

T

gitadmin c97603c937 feat: add dev-workflow and forge-cli skills

Add two engineering skills for implementing tracker tickets end to end:

- dev-workflow: selects workflow:ready-for-agent tickets, runs them in
  isolated worktrees, opens one PR/MR per ticket, reviews, merges, and
  cleans up.
- forge-cli: detects the forge from origin and wraps gh, glab, and tea
  for Gitea/Forgejo, GitHub, and GitLab.

Docs cover install, prerequisites, ticket labels, and per-forge CLI usage.

2026-08-30 12:29:54 -04:00

2.0 KiB

Raw Blame History

name, description

name	description
forge-cli	Provides copy-paste, non-interactive tea, gh, and glab commands for issue and pull or merge request work. Use whenever a task needs tracker inspection, assignment, labels, comments, reviews, CI, or merge operations.

Forge CLI

Use this shared skill instead of reproducing forge CLI syntax in another skill.

Run the bundled read-only preflight with the target repository as the working directory:

bash <resolved-skill-dir>/scripts/detect-forge.sh

Resolve <resolved-skill-dir> from this SKILL.md, not from the target repository.

It prints one selected CLI: forge=tea, forge=gh, or forge=glab. Read only the matching recipe:

forge=tea → references/tea.md
forge=gh → references/gh.md
forge=glab → references/glab.md

Do not load or compare the other recipes. This keeps one forge's syntax in context.

Commands assume the current checkout identifies the repository. Replace ID (issue), PR (pull/merge request), USER, OLD, NEW, BASE, HEAD, TITLE, and BODY_FILE. Keep bodies in a file to avoid quoting and interactive prompts.

Shared safety rules

Use JSON output for reads; inspect the returned object before deciding eligibility, dependencies, or merge readiness.
Use one mutation per state transition, then re-read and confirm the state/label/comment changed.
If a recipe returns an unknown command or flag, run that CLI command's --help; do not switch forge CLIs or guess.
Check command exit status. Authentication, repository resolution, missing permissions, unsupported relationships, and unavailable CI are blockers.
Do not use auto-merge, admin/bypass, or force options. Merge only after every workflow gate passes.

Honor DEV_WORKFLOW_FORGE=tea, gh, or glab when explicitly configured; otherwise use GitHub → gh, GitLab → glab, and other Tea-compatible hosts → tea.

Keep these identifiers distinct: tracker issue/ticket ID, PR/MR ID, durable URL, and local branch name. Never use a branch name as ticket identity.

2.0 KiB Raw Blame History

Forge CLI

Shared safety rules

2.0 KiB

Raw Blame History