메뉴
Read and draft-mutate GitHub PRs, issues, and API endpoints via gh(1). All mutations require --i-approve. PR creation enforces a Linear-state invariant and is logged to .pi/.github-log.jsonl.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Initialize a foreign project to use the pi-seshat system. Symlinks .omp/, drops AGENTS.md and CLAUDE.md templates, scaffolds specs/ and .pi/, updates .gitignore. Dry-run by default; --i-approve gates all mutations.
Read-only cross-source consistency checker. Surfaces drift between Linear issue state, SpecSafe slice files, and commit Spec-Slice trailers. No mutations, no network writes.
Propose-review-apply flow for BMad artifacts (PRDs, UX specs, architecture, briefs). All applies require --i-approve and produce commits with Proposed-By/Approved-By trailers.
Read-only pre-flight verifier. Checks Linear, gh, omp, agent symlinks, and SpecSafe state-file integrity before a dogfood session. No mutations, no --i-approve gate.
This skill should be used when the user asks to add, update, or review evaluation coverage for agent behavior, LLM workflows, SpecSafe slices, harness prompts, or evalfly suites; when a PR changes agent instructions, slash commands, skills, schemas, or workflow-critical behavior; or when asked whether an eval is required.
Fetch, cache, and expose the latest official documentation for registered libraries, SDKs, and APIs. Turns Luci's "always check latest official docs" rule from prose into an executable contract.
| name | github |
| description | Read and draft-mutate GitHub PRs, issues, and API endpoints via gh(1). All mutations require --i-approve. PR creation enforces a Linear-state invariant and is logged to .pi/.github-log.jsonl. |
A consent-gated bash wrapper around gh (the GitHub CLI).
Reads (pr view, issue view, repo view, api <GET-route>) pass through unchanged.
Mutations (PR/issue/API writes) are gated behind --i-approve. Without it, a full DRY-RUN preview is printed and the script exits 0 — dry-run is a successful preview, not an error.
With --i-approve, the mutation executes and one JSON line is appended to .pi/.github-log.jsonl (mode 0600, gitignored).
pr createBefore opening a pull request, the skill:
<KEY>-<slug> or <KEY>__<slug>, e.g. CUR-92-login-fix, CUR-92__login-fix).linear get <KEY> and checks the workflow state. Default PR-ready states: in_progress, in_review.--bypass-linear-check together with --i-approve is the conscious-override path (e.g. hotfix with no ticket, or Linear-less repo).LINEAR_API_KEY is unset, the invariant auto-skips with a single-line notice (Q2 from the spec).Uses gh auth status. If gh is not on PATH, the skill prints the install + auth commands and exits non-zero:
pacman -S github-cli # or see https://cli.github.com
gh auth login --scopes repo,workflow
github pr view <n>
github issue view <n>
github repo view
github api <GET-route>
github pr create [--title=T] [--body=B] [--base=main] [--draft|--ready]
[--bypass-linear-check] [--i-approve]
github pr comment <n> <body> [--i-approve]
github pr edit <n> [--add-label=X] [--remove-label=Y] [--i-approve]
github pr merge <n> [--squash|--rebase|--merge] [--i-approve]
github issue comment <n> <body> [--i-approve]
github issue edit <n> [flags...] [--i-approve]
github api <route> -X POST|PATCH|PUT|DELETE [...] [--i-approve]
pr create defaults to --draft. Pass --ready to open as ready-for-review.
gh pr review is deliberately not wrapped. Human-authored reviews remain a human action.
Every approved mutation appends one JSON line to .pi/.github-log.jsonl:
{"ts":"2026-04-24T12:00:00Z","action":"pr create","args":["pr","create","--title","...","--draft"],"exit":0,"result_url":"https://github.com/org/repo/pull/42","approver":"luci"}
result_url is derived from gh's stdout for PR/comment creation, or from a follow-up gh pr view --json mergeCommit for merges.
# Reads (immediate)
./.omp/skills/github/bin/github.sh pr view 42
./.omp/skills/github/bin/github.sh repo view
# Dry-run mutations (safe, exit 0, prints preview + Linear context)
./.omp/skills/github/bin/github.sh pr create --title="Fix login bug"
./.omp/skills/github/bin/github.sh pr comment 42 "LGTM pending CI"
# Approved mutations (execute + log)
./.omp/skills/github/bin/github.sh pr create --title="Fix login bug" --i-approve
./.omp/skills/github/bin/github.sh pr merge 42 --squash --i-approve
# Conscious override of the Linear invariant
./.omp/skills/github/bin/github.sh pr create --title="hotfix" --bypass-linear-check --i-approve
PI_GITHUB_GH_CMD — replace gh with an alternate command (used by the test harness for stubbing).PI_GITHUB_LINEAR_CMD — replace the default bun run .omp/skills/linear/bin/linear.ts invocation.PI_GITHUB_APPROVER — override the approver name recorded in the log (default: luci).