BIG pi update with claude chat
This commit is contained in:
Jonas H
153
pi/.pi/agent/skills/ask-claude/SKILL.md
Normal file
153
pi/.pi/agent/skills/ask-claude/SKILL.md
Normal file
@@ -0,0 +1,153 @@
|
||||
---
|
||||
name: ask-claude
|
||||
description: "Invoke Claude (any agent or model) for an opinion, review, or analysis. Use when the user asks you to ask a specific Claude about something specific — e.g. trade-offs of an approach, a focused review, or a second opinion."
|
||||
---
|
||||
|
||||
# Ask Claude
|
||||
|
||||
Use `ask_claude` to consult Claude with any combination of agent, model, question, and prompt.
|
||||
|
||||
## Parameters
|
||||
|
||||
| Parameter | Required | Description |
|
||||
|-----------|----------|-------------|
|
||||
| `prompt` | yes | The content for Claude to reason about (context, code, plan, bug report, etc.) |
|
||||
| `question` | no | What specifically to ask — prepended as a focused review directive |
|
||||
| `agent` | no | Agent name from `~/.claude/agents/`. See **Available agents** below. |
|
||||
| `model` | no | Override the model: `"opus"`, `"sonnet"`, `"haiku"` |
|
||||
| `session_id` | no | Resume a prior conversation (returned in every response) |
|
||||
|
||||
If neither `agent` nor `model` is set, defaults to Claude Sonnet.
|
||||
|
||||
> **Multi-turn:** Every response includes a `session_id`. Pass it back in a subsequent `ask_claude()` call to continue the same conversation with the same agent/model.
|
||||
|
||||
## Available agents
|
||||
|
||||
See `~/.claude/agents/` for the full list. Common agents:
|
||||
|
||||
| Agent | Model | Tools | Use when |
|
||||
|-------|-------|-------|----------|
|
||||
| `plan_review` | Opus | Read, Bash | Reviewing plans for correctness, completeness, feasibility, and risk |
|
||||
| `code_review` | Sonnet | Read, Bash, Edit, Write | Reviewing implementations; can apply fixes directly |
|
||||
| `debug` | Sonnet | Read, Bash | Tracing bugs and root causes; will NOT apply fixes |
|
||||
| `oracle` | Opus | Read, Bash | Hard problems, architectural decisions, when you're stuck |
|
||||
|
||||
Pick the agent that matches the task. If unsure, ask the user which agent to use, or use a raw `model=` instead of an agent.
|
||||
|
||||
## Common patterns
|
||||
|
||||
### Plan review
|
||||
```
|
||||
ask_claude({
|
||||
agent: "plan_review",
|
||||
question: "Review for correctness, completeness, feasibility, and risk. Highlight missing steps or unclear requirements.",
|
||||
prompt: `
|
||||
## Project Context
|
||||
[Key facts from CLAUDE.md]
|
||||
|
||||
## Codebase Exploration
|
||||
[Modules/files you read]
|
||||
|
||||
## Implementation Plan
|
||||
[Your full plan, step by step]
|
||||
|
||||
## Open Questions
|
||||
[Anything uncertain]
|
||||
`
|
||||
})
|
||||
```
|
||||
|
||||
### Code review (with fix capability)
|
||||
```
|
||||
ask_claude({
|
||||
agent: "code_review",
|
||||
question: "Review for bugs, architectural issues, style, and correctness. Apply fixes for any issues you find.",
|
||||
prompt: `
|
||||
## Project Conventions
|
||||
[Relevant context not in CLAUDE.md]
|
||||
|
||||
## What Was Implemented
|
||||
[Brief description]
|
||||
|
||||
## Plan That Was Followed
|
||||
[The implementation plan]
|
||||
|
||||
## Files Changed
|
||||
- path/to/file.ts — [what changed]
|
||||
|
||||
## Code to Review
|
||||
[Paste key sections OR instruct the agent to read the files above]
|
||||
`
|
||||
})
|
||||
```
|
||||
|
||||
### Debugging
|
||||
```
|
||||
ask_claude({
|
||||
agent: "debug",
|
||||
question: "Trace the root cause. Provide specific file paths, line numbers, and the exact code responsible. Suggest a fix but do not apply it.",
|
||||
prompt: `
|
||||
## The Issue
|
||||
[What's happening vs. what should happen]
|
||||
|
||||
## Error Output
|
||||
[Any logs, stack traces, or error messages]
|
||||
|
||||
## Relevant Files
|
||||
- path/to/file.ts — [why it's relevant]
|
||||
|
||||
## What I've Already Tried
|
||||
[Hypotheses tested, things ruled out]
|
||||
`
|
||||
})
|
||||
```
|
||||
|
||||
### Oracle (hard problems)
|
||||
```
|
||||
ask_claude({
|
||||
agent: "oracle",
|
||||
question: "Analyze this problem and provide guidance. Explain your reasoning and recommend the best path forward.",
|
||||
prompt: `
|
||||
## The Problem
|
||||
[What you're trying to solve and why it's hard]
|
||||
|
||||
## Codebase Context
|
||||
[Relevant files, modules, and patterns explored]
|
||||
|
||||
## Options Considered
|
||||
[Approaches evaluated and their trade-offs]
|
||||
|
||||
## What I Need Clarified
|
||||
[Specific question or decision point]
|
||||
`
|
||||
})
|
||||
```
|
||||
|
||||
### Free-form model question (no agent)
|
||||
```
|
||||
ask_claude({
|
||||
model: "opus",
|
||||
question: "What are the trade-offs of this approach vs using a message queue?",
|
||||
prompt: `We're considering polling a database table every 5 seconds for new jobs instead of a queue...`
|
||||
})
|
||||
```
|
||||
|
||||
### Continuing a conversation
|
||||
When Claude returns a `session_id` in its response, pass it back to continue the same conversation:
|
||||
```
|
||||
ask_claude({
|
||||
agent: "code_review",
|
||||
question: "Apply the fixes you identified.",
|
||||
session_id: "<session_id from prior response>",
|
||||
prompt: "Please proceed with the fixes."
|
||||
})
|
||||
```
|
||||
|
||||
## After the response
|
||||
|
||||
- Summarize Claude's key points for the user.
|
||||
- If Claude raises blockers or important concerns, address them before proceeding.
|
||||
- For plan reviews: if blockers or missing steps are flagged, update the plan and re-invoke if changes are significant.
|
||||
- For code reviews: Claude (via `code_review`) may apply fixes directly — summarize what was changed.
|
||||
- For debugging: apply the fix yourself or delegate to a coding agent.
|
||||
- For oracle: proceed with the recommended approach, or loop back if more clarification is needed.
|
||||
Reference in New Issue
Block a user