keisei/KeiSeiKit-1.0
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
KeiSeiKit-1.0/skills/fix-issue/SKILL.md
Parfii-bot 0be354a920 KeiSeiKit-public — clean state 
Single-commit clean baseline after security scrub of niche-tells,
project codenames, internal jargon, and contributor-email leaks.

Contents:
- 100 Rust crates (_primitives/_rust/)
- 37 agent manifests (_manifests/) + generated specs (_generated/)
- 67 user-invocable skills (skills/)
- 33 hooks (hooks/)
- Composition blocks (_blocks/)
- Documentation (docs/, README.md)
- TS adapter packages (_ts_packages/)
- Assembler (_assembler/)
- Roles (_roles/)
- Templates (_templates/)
- Forgejo CI (.forgejo/)

Author: Denis Parfionovich <info@greendragon.info>

License: see LICENSE.
2026-05-01 12:09:03 +08:00

1.5 KiB
Raw Blame History

name description disable-model-invocation arguments
fix-issue Use when fixing a GitHub issue — reproduce, trace root cause, fix, add regression test true
name description required
issue GitHub issue number or URL true

Fix Issue Workflow

Step 1: Load Issue Context

  • Fetch issue details: gh issue view $issue --json title,body,labels,comments
  • Read all comments for additional context
  • Identify: expected behavior, actual behavior, reproduction steps

Step 2: Reproduce

  • Set up reproduction environment based on issue description
  • Write a failing test that captures the bug (TDD approach)
  • If cannot reproduce — ask user for more context, do NOT guess

Step 3: Trace Root Cause

  • Use Grep/Glob to find relevant code paths
  • Trace execution flow from entry point to failure
  • Identify the ROOT CAUSE, not symptoms
  • Check DECISIONS.md for related past decisions

Step 4: Checkpoint

  • git commit current state: checkpoint: before fix-issue #$issue

Step 5: Fix

  • Fix at the root cause level, NOT overlay/patch
  • Follow Constructor Pattern: if fix grows file >200 lines, decompose
  • Ensure fix doesn't break other functionality

Step 6: Verify

  • Run the failing test — must pass now
  • Run full test suite — no regressions
  • If test suite doesn't exist, create at minimum:
    • Test for the specific bug (regression test)
    • Test for the happy path of affected function

Step 7: Commit

  • fix: <description of what was fixed> (closes #$issue)
  • Update TODO.md if issue was tracked there