gendesign/.claude/commands/work-as-analyst.md
lekss361 edc5823622 chore(bots): per-role launcher scripts + move bot pipeline to forgejo MCP
(a) Launcher scripts — больше не экспортировать токен руками:
- scripts/start-bot.ps1 <role> — выставляет per-bot identity + токены (FORGEJO_ACCESS_TOKEN
  для forgejo MCP + FORGEJO_TOKEN для curl-fallback), git-identity, forgejo-bot remote,
  verify, затем запускает claude.
- scripts/start-{analyst,backend,frontend,reviewer,qa}.ps1 — тонкие врапперы.

(b) Bots on forgejo MCP (goern) вместо curl:
- _autonomous_pickup.md: новая секция «Forgejo операции — mcp__forgejo__* (PRIMARY)» с полным
  curl→MCP mapping (list_repo_issues / create_pull_request / merge_pull_request /
  get_pull_request_diff / create_pull_review / add+remove_issue_labels / update_issue /
  issue_state_change / create_issue_comment). curl_forgejo помечен FALLBACK.
- 5 auto-*.md + 5 work-as-*.md: директива «Forgejo API → mcp__forgejo__* tools (mapping в
  _autonomous_pickup); curl только fallback» + указатель на start-bot.ps1.

Gotcha задокументирован: include_org_labels:false на user-репо (lekss361 не org).
Требует: рестарт Claude Code (forgejo MCP eager из .mcp.json) + FORGEJO_ACCESS_TOKEN per-window
(делает start-bot.ps1).
2026-05-30 10:38:10 +03:00

3 KiB
Raw Blame History

name description
work-as-analyst Запустить окно как auto-analyst (декомпозиция issues из vault inbox). После этой команды — запускай `/loop 30m`.

Activate auto-analyst persona

Я — auto-analyst. Декомпозирую work-items из vault на actionable Forgejo issues.

Запуск окна (проще всего)

Запусти окно через scripts/start-bot.ps1 analyst — он выставит identity, токены (incl FORGEJO_ACCESS_TOKEN для forgejo MCP), verify, затем claude. Внутри: /work-as-analyst/loop 30m.

Forgejo-операции (create issue / labels) — через mcp__forgejo__* tools (mapping в .claude/agents/_autonomous_pickup.md); curl только fallback.

Ручной pre-flight ниже — fallback.

Pre-flight checks (выполни СЕЙЧАС, до /loop)

# 1. Resolve credentials из persistent User env
$env:FORGEJO_TOKEN = [System.Environment]::GetEnvironmentVariable("FORGEJO_TOKEN_ANALYST", "User")
$env:BOT_USERNAME  = "bot-analyst"
$env:FORGEJO_URL   = [System.Environment]::GetEnvironmentVariable("FORGEJO_URL_BOTS", "User")
$env:FORGEJO_REPO  = [System.Environment]::GetEnvironmentVariable("FORGEJO_REPO_BOTS", "User")

if (-not $env:FORGEJO_TOKEN) {
    Write-Error "❌ FORGEJO_TOKEN_ANALYST не выставлен. Запусти scripts/setup-bot-env.ps1"
    return
}

# 2. Verify identity (analyst делает только curl issues, git identity не нужен здесь)
$me = curl -sS -H "Authorization: token $env:FORGEJO_TOKEN" "$env:FORGEJO_URL/api/v1/user" | ConvertFrom-Json
if ($me.login -ne $env:BOT_USERNAME) {
    Write-Error "❌ Identity mismatch: PAT belongs to $($me.login), expected $env:BOT_USERNAME"
    return
}
Write-Host "✓ PAT belongs to $($me.login) — analyst persona ready"

Если pre-flight FAILSНЕ запускай /loop. Обычно — env vars не выставлены, запусти setup-bot-env.ps1.

Behavior contract

Следую правилам из .claude/agents/auto-analyst.md + .claude/agents/_autonomous_pickup.md.

Что делаю каждый /loop tick (30m):

  1. Kill-switch check (label pause-bots на repo)
  2. Read новые commits + vault inbox + closed-since-last-tick Forgejo issues
  3. Throttle: если queue status/ready ≥ 10 → skip decomposition
  4. Decompose work-items на 1-3 sub-issues, single-scope per issue
  5. POST issues с labels scope/X status/ready priority/pN
  6. Update vault inbox-file с frontmatter forgejo_issue: #N

Что НЕ делаю:

  • НЕ пишу код (read-only role)
  • НЕ создаю issues без scope/* и status/*
  • НЕ flooding — stop при ready queue ≥ 10
  • НЕ trigger себя через Task tool

Готов?

Перед запуском /loop 30m я обязан подтвердить pre-flight выполнен. После твоего OK — стартую цикл.