القائمة
Use when a Foreman run appears stuck, has missing artifacts, stale projections, failed PR gates, confusing inbox/debug output, or potentially missing phase reports.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Use when changing Foreman's Node/Pi worker bridge, detached worker config/env, Pi SDK sessions, custom tools, tool policy, observability, worker terminal events, or sandboxed Pi resource paths.
Use when a Foreman change may affect documentation, commands, workflows, prompts, setup, troubleshooting, operator expectations, or skill inventory/package behavior.
Use when changing Foreman's Elixir/OTP backend under packages/foreman_server: event store, projections, scheduler, run/phase actors, worker protocol, PR/VCS reconciliation, operations, auth, or storage/test isolation.
Use when deciding between Foreman retry, reset, doctor --fix, worktree clean, abandon, or clean-state for failed/stuck/obsolete runs, branches, worktrees, or PRs.
Use when changing Foreman's Git/Jujutsu support, VcsBackend abstraction, worktree/workspace handling, finalize/rebase/merge/push commands, or workflow/project VCS configuration.
Use when editing or diagnosing Foreman workflow YAML, bundled prompts, pipeline executor behavior, phase artifacts, retries, command/bash/builtin phases, PR gates, or stale runtime prompt/workflow copies.
| name | foreman-pipeline-diagnosis |
| description | Use when a Foreman run appears stuck, has missing artifacts, stale projections, failed PR gates, confusing inbox/debug output, or potentially missing phase reports. |
Use this skill for stuck agents, missing reports, projection lag, status/watch/debug mismatch, PR wait/merge failures, or ambiguous run/task state.
foreman status or foreman watch for current projection state.foreman debug <task-id> --raw when exact artifacts/logs/mail are needed before AI analysis.foreman inbox --task <task-id> --events for lifecycle events, phase completions/retries/verdicts, Overwatch nudges, and agent-error mail.foreman server doctor for projection lag, DB/projection/worker/VCS/provider/integration health, and metrics./api/v1/runs/<run-id>/debug?view=raw only when CLI views are insufficient and auth context is available.Classify the issue before mutating state: projection lag, hung Pi SDK session, provider rate limit, stale prompt/workflow, missing artifact, PR gate failure, merge conflict, true implementation failure, or infrastructure/runtime startup failure.
artifact field, report directory paths from debug/report, trace warnings, and actual file existence.foreman init --force after a build or use foreman doctor --fix where appropriate.