AgentSkillsCN

plan:findings-resume

将方案中的发现分类整理为待处理的问题与研究课题。从方案目录中读取发现内容,判断哪些应转化为问题,哪些需作为研究更新,并分别记录到相应位置。

SKILL.md
--- frontmatter
name: plan:findings-resume
description: Triage findings from a plan into issues and research. Reads findings/ from a plan directory, decides what becomes an issue or research update, and writes them to the appropriate locations.
allowed-tools: Bash(git log:*), Bash(git diff:*)

Plan Findings Resume Skill

Triage findings recorded during plan implementation into issues and research updates.

Process

  1. Identify the target plan:

    • If the user provides a plan number (e.g., /plan:findings-resume 0018), use that plan directly: .gumbo/plans/NNNN-*/
    • If no number is provided, scan for plans with findings:
      • Look for .gumbo/plans/*/findings/ directories (exclude .gumbo/plans/archive/)
      • Read .plan-state.json for each to check status
      • If one plan has findings, use it
      • If multiple plans have findings, list them and ask the user to choose:
        code
        Found findings in multiple plans:
        
        1. `.gumbo/plans/0018-lr-rl-remaining-fixes/` - 4 findings (in_progress)
        2. `.gumbo/plans/0020-edge-routing/` - 2 findings (in_progress)
        
        Which plan's findings should I triage?
        
      • If no plans have findings, report that and suggest /plan:findings-create
  2. Read all findings:

    • Read every .md file in .gumbo/plans/NNNN-name/findings/
    • Parse the finding metadata: Type, Task, Date
    • Group findings by type: discovery, diversion, plan-error, note, todo, cleanup
  3. Present findings summary to the user:

    code
    **Plan:** `.gumbo/plans/NNNN-feature-name/`
    **Findings:** N total
    
    | # | Finding | Type | Task | Proposed Action |
    |---|---------|------|------|-----------------|
    | 1 | Short title | todo | 2.1 | Issue |
    | 2 | Short title | discovery | 1.3 | Research update |
    | 3 | Short title | note | 3.1 | No action needed |
    
    **Proposed actions:**
    - **Issues (N):** Findings 1, 4, 5 → new issue set `.gumbo/issues/NNNN-description/`
    - **Research (N):** Finding 2 → update `.gumbo/research/NNNN-topic/`; Finding 6 → new research
    - **No action (N):** Findings 3, 7 — informational only
    
    Should I proceed with these actions? You can adjust any finding's disposition.
    
  4. Wait for user approval before creating any issues or research.

  5. Create issues from findings that warrant them:

    • Find the next issue set number by checking .gumbo/issues/ for the highest NNNN-* prefix
    • Create .gumbo/issues/NNNN-kebab-description/ directory
    • Write issues.md index file with:
      • Summary of how issues were identified (from plan findings)
      • Issue index table linking to individual issue files
      • Categories grouping related issues
      • Cross-references back to the source plan and findings
    • Create .gumbo/issues/issues/ subdirectory with individual issue files
    • Each issue file includes:
      • Severity, category, status (Open)
      • Description derived from the finding
      • Reproduction steps (from finding details or plan context)
      • Link back to the source finding: .gumbo/plans/NNNN-name/findings/finding-name.md
    • Follow the format conventions in .gumbo/issues/CLAUDE.md
  6. Route research findings to the appropriate location:

    For each finding that warrants research:

    Update existing research if the finding relates to an active or archived research topic:

    • Scan .gumbo/research/NNNN-*/research-plan.md and .gumbo/research/archive/NNNN-*/research-plan.md for topic matches
    • If a matching research directory exists and is active (.gumbo/research/NNNN-*/):
      • Add a new findings file: .gumbo/research/NNNN-topic/from-plan-MMMM-description.md
      • Use the standard research findings format (Summary, Where, What, How, Why, Key Takeaways)
      • Note the source: "Discovered during implementation of plan MMMM"
    • If the matching research is archived:
      • Note this in the output — the user may want to create follow-up research

    Create new research if the finding opens a new topic not covered by existing research:

    • Find the next research number by checking both .gumbo/research/ and .gumbo/research/archive/
    • Create .gumbo/research/NNNN-topic-name/ with a research plan
    • Follow .gumbo/research/CLAUDE.md conventions
    • Set status to PLANNED — the user can run /research:resume to investigate
  7. Report results:

    code
    **Findings triage complete for plan NNNN:**
    
    **Issues created:** `.gumbo/issues/NNNN-description/`
    - Issue 01: [title] (High)
    - Issue 02: [title] (Medium)
    
    **Research updated:** `.gumbo/research/NNNN-topic/`
    - Added: `from-plan-MMMM-description.md`
    
    **Research created:** `.gumbo/research/NNNN-new-topic/`
    - Status: PLANNED — run `/research:resume` to investigate
    
    **No action:** 2 findings (informational)
    
    **Source:** `.gumbo/plans/MMMM-name/findings/` (N findings triaged)
    

Finding Type → Action Mapping

These are defaults — the user can override any finding's disposition:

Finding TypeDefault ActionRationale
todoIssueDeferred work needs tracking
cleanupIssueTechnical debt needs tracking
plan-errorResearch update or issueIncorrect assumptions may need investigation or just a fix
discoveryResearch updateNew understanding should feed back to research
diversionNote in issue or researchDocument why the plan changed
noteNo actionInformational, already captured in findings

Example Output


Plan: .gumbo/plans/0020-edge-routing/ Findings: 5 total

#FindingTypeTaskProposed Action
1Diamond nodes need special attachment logicdiscovery2.1Research update → .gumbo/research/0013-visual-comparison-fixes/
2Router doesn't handle 3+ waypointstodo3.2Issue (High)
3Plan assumed edges sorted by rankplan-error2.3Issue (Medium)
4Refactored render_edge to take PathSegmentdiversion3.1No action
5Need to revisit label placement after routingtodo3.4Issue (Low)

Proposed actions:

  • Issues (3): Findings 2, 3, 5 → new issue set .gumbo/issues/0003-edge-routing-findings/
  • Research (1): Finding 1 → update .gumbo/research/0013-visual-comparison-fixes/
  • No action (1): Finding 4 — informational diversion

Should I proceed with these actions?