菜单
Sessions stored as trees (not lists). /fork creates a branch from any point; /tree navigates; /branch labels a path; /export produces HTML for review. All branches live in one session file under sessions/<project>/<session_id>.json.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Switch model mid-session preserving thinking blocks. Used by /model command and by BRD §6.2 failover when the primary provider rate-limits or fails.
Six-phase ReAct loop (pre-check, thinking, self-critique, action, tool, post). Activates per-workflow via the thinking_level knob in config/workflows.yaml. Replaces standard ReAct for workflows where independent verification of the reasoning improves outcomes.
Mines completed sessions for repeating {tool sequence → outcome} tuples. Scores by frequency × success_rate × novelty. High-scoring tuples become "instincts" — candidate skill seeds — in instincts/pending/.
Walk-back algorithm for the Spec-Auditor subagent. Given a failure at phase N, identifies the earliest phase whose spec, if tightened, would have prevented the failure. Proposes a surgical amendment.
Progressive context refinement for subagents. Don't dump everything; retrieve in passes. Start with a list of file paths and one-line abstracts; load full content only when the abstract proves insufficient.
Create a Business Requirements Document through Socratic five-dimension dialogue with the human. First step of the SDLC pipeline, before spec/design/build. Supports greenfield projects or single-feature additions.
| name | tree-sessions |
| description | Sessions stored as trees (not lists). /fork creates a branch from any point; /tree navigates; /branch labels a path; /export produces HTML for review. All branches live in one session file under sessions/<project>/<session_id>.json. |
| when_to_use | ["hard task where the first approach often fails — explore alternatives without losing the original","long debugging session — annotate the search tree with /branch","presenting a session to a reviewer — /export to HTML"] |
| brd_ref | §4.5 |
Pi-mono (BRD §10.3 §4.5) treats sessions as trees: each turn is a node, and you can fork the tree at any point to try an alternative without abandoning the original. This is essential for hard tasks where the first approach fails.
sessions/<project>/<session_id>.json
{
"session_id": "<uuid>",
"root_turn_id": "<uuid>",
"turns": [ {turn_id, parent_turn_id?, branch?, role, content, timestamp}, ... ],
"active_path": ["<turn_id>", ...],
"branches": { "<label>": "<turn_id>" }
}
sessions/archive/<session_id>/transcript.json
-- pre-compaction transcript snapshot (BRD §4.3)
| Command | Action |
|---|---|
/tree | Render the session graph in-place with active path highlighted. |
/fork [<turn_id>] | Create a new branch from turn_id (default: current). All subsequent turns go to the new branch until another /fork or /tree switch. |
/branch <name> | Label the current path so it's retrievable later. |
/tree <label> | Switch the active path to a labeled branch. |
/export [<format>] | Render the session as HTML (default) or Markdown for review. |
Every turn is saved. The orchestrator maintains the file as JSONL-internally-but-JSON-on-disk: each turn appended atomically; the file is re-canonicalized periodically. Concurrent reads tolerate the in-progress state.
/branch <name> to keep your bearings./fork to undo. git revert is the better tool for undoing. Forks are for exploring — you want both branches to remain visible.Read-and-reimplement of earendil-works/pi/packages/pi-coding-agent/src/session/ (MIT). The implementation lives at scripts/tree-sessions.js. See BRD §10.3 §4.5.