القائمة
Diagnose a running or stalled paude container session. Use when paude seems stuck, harvest returned empty, checking paude status, debugging 403 proxy blocks, or deciding wait vs harvest vs reset.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Review all pending changes against repo conventions before committing
Mark files as human-reviewed with specific validation types
Harvest and locally merge changes from a paude container session. Use when pulling agent work from paude, running paude harvest, merging session commits, importing submodule changes from a container, or fixing failed harvest/submodule fetch.
Start a paude container session for fire-and-forget agent work. Use when creating a paude session, delegating a task to paude, running work in an isolated container, setting up a paude worktree, or launching pi/claude/gemini in podman.
Write a task spec file for a paude container agent. Use when delegating work to paude, preparing a paude prompt-file, writing fire-and-forget agent tasks, or scoping submodule work for harvest.
Create or update a project BRIEF.md — scaffolds planning structure for work that crosses the 5-file / multi-session threshold
| name | paude-triage |
| description | Diagnose a running or stalled paude container session. Use when paude seems stuck, harvest returned empty, checking paude status, debugging 403 proxy blocks, or deciding wait vs harvest vs reset. |
| argument-hint | <session-name> |
| allowed-tools | Read Shell Glob Grep |
<essential_principles>
Active = agent may still be working; Idle = done or waiting for input.AGENT-NOTES.md and container git log before trusting agent handoff prose.</essential_principles>
- Commands: `.agents/skills/paude-harvest/references/commands.md` - Harvest: `.agents/skills/paude-harvest/SKILL.md` - Narrative: `docs/ai-engineering/paude-getting-started.md`paude status <session-name>
paude list
Record: STATE (Active/Idle), ACTIVITY, SUMMARY.
If <session-name> missing from $ARGUMENTS, list sessions and ask.
paude blocked-domains <session-name>
If recent 403s, recommend:
paude allowed-domains <session-name> --add <host>
podman exec paude-<session-name> bash -lc 'cd /pvc/workspace && git branch && git log --oneline -3 && git status -sb'
Check for AGENT-NOTES.md:
podman exec paude-<session-name> bash -lc 'test -f /pvc/workspace/AGENT-NOTES.md && head -40 /pvc/workspace/AGENT-NOTES.md'
podman exec paude-<session-name> bash -lc 'git -C /pvc/workspace submodule status | head -15'
Empty submodule dirs (- prefix) → init needed in container.
| Signal | Recommendation |
|---|---|
| Active, recent agent output | paude wait <session> — check back |
Idle, commits on harvest/*, clean tree | paude-harvest <session> --merge |
| Idle, dirty tree, no commits | Send harvest-prep prompt (paude-spec/templates/harvest-prep-prompt.md) |
| Idle, HARVEST READY in notes | paude-harvest — verify SHAs first |
| 403 blocked domains | paude allowed-domains --add then reconnect |
| Empty submodule | git submodule update --init inside container |
Wrong branch (on main with WIP) | Send harvest-prep or manual commit instructions |
| User wants to abandon | paude reset <session> — warn about unharvested work |
One paragraph: state, finding, single recommended command.
<success_criteria>