Setup do GitHub
1. Verificação (somente leitura)
command -v gh >/dev/null && gh --version | head -1 || echo "NO_GH"
gh auth status 2>&1 | grep -E "Logged in|Token scopes" || echo "NO_AUTH"
gh repo view --json nameWithOwner,owner -q '.nameWithOwner + " " + .owner.login' 2>/dev/null || echo "NO_REPO"
cat .planning/github.json 2>/dev/null || echo "NO_CONFIG"
| Resultado | Ação |
|---|---|
NO_GH |
instruir a instalação (https://cli.github.com/) e PARAR |
NO_AUTH |
pedir ! gh auth login e PARAR |
scopes sem project |
pedir ! gh auth refresh -s project (Projects exige esse scope; repo também é necessário) |
NO_REPO |
usar os argumentos como owner/repo ou perguntar |
2. Configuração
Pergunte, uma coisa por vez, só o que faltar:
- Repositório padrão das issues (
owner/repo) — sugira o detectado. - Dono dos Projects:
@me(sua conta) ou a organização do repo. - Project ativo: listar os existentes
(
gh project list --owner <dono> --format json -q '.projects[] | "\(.number) \(.title)"'), escolher um, ou deixar vazio e criar depois com a skillgithub-project.
Grave .planning/github.json (merge, nunca apague chaves existentes):
{
"repo": "owner/repo",
"owner": "@me",
"project": { "number": 7, "url": "https://github.com/users/me/projects/7", "spec": ".planning/github/project-7.spec.json" }
}
.planning/github/ guarda os mapas de publicação (<slug>.map.json) e as specs efetivas dos
Projects — devem ser versionados junto com o roadmap para que outro dev continue o publish.
3. Resumo
✅ pwdev-github configurado
gh {versão} · scopes: {scopes}
Repo: {owner/repo} · Projects de: {owner} · Project ativo: {#n título | nenhum}
👉 github-project → criar Project a partir de template
👉 github-publish <roadmap.json> → publicar roadmap
👉 "fecha a issue #12", "move #14 para Em andamento" → skill github-issues
Idioma: responda no idioma de .planning/config.json (lang); sem config, no idioma do usuário. Caminhos <plugin-root>/..., references/, scripts/ e templates/ são relativos à raiz do plugin; nomes de ferramentas e a forma de citar comandos dependem do runtime (references/runtime.md).