Add interactive analysis workflow with documented discussions and CLI exploration

- Introduced `analyze-with-file` command for collaborative analysis.
- Implemented session management for new and continued analysis sessions.
- Developed structured phases for topic understanding, exploration, discussion, and conclusion synthesis.
- Created detailed documentation for the workflow, including examples and implementation details.
- Added Codex prompt for deep analysis and exploration of codebase and concepts.
This commit is contained in:
catlog22
2026-01-25 11:08:13 +08:00
parent 9cff6f5f43
commit 6875108dda
5 changed files with 1426 additions and 669 deletions

View File

@@ -506,7 +506,7 @@ Each line is a JSON object:
## Iteration Flow
```
First Call (/prompts:debug-with-file BUG="error"):
First Call (BUG="error"):
├─ No session exists → Explore mode
├─ Extract error keywords, search codebase
├─ Document initial understanding in understanding.md
@@ -514,7 +514,7 @@ First Call (/prompts:debug-with-file BUG="error"):
├─ Add logging instrumentation
└─ Await user reproduction
After Reproduction (/prompts:debug-with-file BUG="error"):
After Reproduction (BUG="error"):
├─ Session exists + debug.log has content → Analyze mode
├─ Parse log, evaluate hypotheses
├─ Update understanding.md with:
@@ -578,32 +578,27 @@ Also we checked A and found B, and then we checked C...
Why is config value None during update?
```
## Comparison with /prompts:debug
## Key Features
| Feature | /prompts:debug | /prompts:debug-with-file |
|---------|-----------------|---------------------------|
| NDJSON logging | ✅ | ✅ |
| Hypothesis generation | Manual | Analysis-assisted |
| Exploration documentation | ❌ | ✅ understanding.md |
| Understanding evolution | ❌ | ✅ Timeline + corrections |
| Error correction | ❌ | ✅ Strikethrough + reasoning |
| Consolidated learning | ❌ | ✅ Current understanding section |
| Hypothesis history | ❌ | ✅ hypotheses.json |
| Analysis validation | ❌ | ✅ At key decision points |
| Feature | Description |
|---------|-------------|
| NDJSON logging | Structured debug log with hypothesis tracking |
| Hypothesis generation | Analysis-assisted hypothesis creation |
| Exploration documentation | understanding.md with timeline |
| Understanding evolution | Timeline + corrections tracking |
| Error correction | Strikethrough + reasoning for wrong assumptions |
| Consolidated learning | Current understanding section |
| Hypothesis history | hypotheses.json with verdicts |
| Analysis validation | At key decision points |
## Usage Recommendations
## When to Use
Use `/prompts:debug-with-file` when:
Best suited for:
- Complex bugs requiring multiple investigation rounds
- Learning from debugging process is valuable
- Team needs to understand debugging rationale
- Bug might recur, documentation helps prevention
Use `/prompts:debug` when:
- Simple, quick bugs
- One-off issues
- Documentation overhead not needed
---
**Now execute the debug-with-file workflow for bug**: $BUG