Blacksite/.agents/skills/blacksite-gitea-sync/SKILL.md

1.4 KiB

name description
blacksite-gitea-sync Read and synchronize exact Blacksite Gitea issues, epics, and milestones with current scope, implementation state, verification evidence, canonical documentation, and release-candidate status while avoiding duplicate issues and noisy updates.

Blacksite Gitea synchronization

Read .codex/workflow.toml and the state model. Use the configured Gitea connector; do not scrape or invent tracker state.

Supported modes are read, plan, status, scope-delta, candidate, and close.

  1. Read exact known issue, parent epic, milestone, and recent relevant comments first. Search broadly only to locate an unknown item or prevent a duplicate.
  2. Summarize acceptance locally and create a dry-run mutation plan before every write.
  3. Follow configured permissions. Creation and scope/milestone changes require explicit authority; closure is candidate-only; delete/reopen is explicit.
  4. Add at most one meaningful status comment per completed slice.
  5. Distinguish working-tree implementation from engineering-complete, acceptance-in-progress, candidate-ready, and closure evidence.
  6. Mark acceptance only when code, focused tests, and required native/package evidence exist and remain valid.
  7. On failure, re-read the exact item, detect partial success, and retry only the missing operation.

Never push or close as a side effect. Record remote mutations and their readback in session state.