القائمة
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.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
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.
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.
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.
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.
استنادا إلى تصنيف SOC المهني
| name | env-doctor |
| description | 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. |
Single-shot diagnostic: runs five checks in a fixed order and prints a PASS / FAIL / SKIP line per item. Read-only — touches no env vars or files and only shells out to the configured probe commands.
bun run .omp/skills/env-doctor/bin/env-doctor.ts [--strict] [--json]
| Id | Label | Required? | Description |
|---|---|---|---|
| (a) | LINEAR_API_KEY | optional | Env present + linear list --limit=1 exits 0. SKIP if env unset; FAIL under --strict. |
| (b) | gh auth | yes | gh auth status exits 0. |
| (c) | omp config | yes | omp --version exits 0. Searches PATH, bun pm bin -g, $BUN_INSTALL/bin, ~/.bun/bin, ~/.cache/.bun/bin, ~/.local/share/bun/bin, and /usr/local/bin. |
| (d) | agent symlinks | yes | ~/.omp/agent/{hooks,tools,agents,skills} each realpath-resolve to $PWD/.omp/<name>. |
| (e) | SpecSafe state | optional | .pi/.specsafe-state.json parses; absent → SKIP by default, FAIL under --strict. Corrupt file is always FAIL. |
A check classified as OPTIONAL with its prerequisite absent reports SKIP in default mode and FAIL under --strict. A present-but-broken optional check is always FAIL.
| Flag | Effect |
|---|---|
--strict | Elevates OPTIONAL checks to REQUIRED — a missing prerequisite becomes FAIL instead of SKIP. |
--json | Emits a single JSON object to stdout. Top-level keys are a..e, each { status, note? }. |
--json and --strict may be combined.
| Code | Meaning |
|---|---|
| 0 | All checks PASSed; optional checks may have SKIPped. |
| 1 | At least one check FAILed. |
| 2 | Invocation error (unknown flag). |
For black-box testing, spawn points can be replaced via env vars. When set, the skill spawns the named executable and uses its exit code/stdout/stderr in place of the real probe.
| Env var | Replaces |
|---|---|
PI_ENVDOCTOR_LINEAR_CMD | bun run .omp/skills/linear/bin/linear.ts list --limit=1 |
PI_ENVDOCTOR_GH_CMD | gh auth status |
PI_ENVDOCTOR_OMP_CMD | omp --version |
Every output line is filtered through a sanitizer that replaces literal occurrences of LINEAR_API_KEY with <redacted>. Lengths and hash digests are never printed; only PASS / FAIL / SKIP plus a redacted human note.