mirror of
https://github.com/rohitg00/skillkit.git
synced 2026-11-20 20:34:46 +00:00
feat: add skillkit doctor command and enhance skillkit status (#64)
* feat: add `skillkit doctor` command and enhance `skillkit status` - New `skillkit doctor` command with 10 health checks across 3 categories (environment, configuration, skills) with --json and --fix flags - Enhanced `skillkit status` shows project overview dashboard when no active session exists instead of bare "No active session found" message - Overview includes agent, config, version, skills count, recent history * feat: add skill activity log, session snapshots, and session explain Three new session intelligence features: - Activity Log: tracks which skills were active per git commit (`skillkit activity` with --skill, --limit, --json flags) - Session Snapshots: save/restore named snapshots of session state (`skillkit session snapshot save|restore|list|delete`) - Session Explain: structured summary of current session (`skillkit session explain` with --json, --no-git flags) Includes path traversal protection on snapshot names, YAML validation on parsed activity data, and robust error handling on snapshot restore. 983 tests passing (942 core + 41 CLI including 14 E2E tests). * feat: add issue planner - generate plans from GitHub Issues New `skillkit issue plan` and `skillkit issue list` commands that fetch GitHub Issues via `gh` CLI and generate StructuredPlans. Parses checkboxes, file mentions, and labels from issue body. 29 new tests, all passing. * fix: address CodeRabbit review suggestions for PR #64 - doctor.ts: use execFileSync, typed AgentType, remove as-any casts - activity.ts: validate parseInt with radix and NaN guard - issue.ts: wrap JSON.parse in try/catch for gh CLI output - issue-planner.ts: guard JSON.parse, fix includeTests no-op ternary, remove duplicate IssuePlanMetadata (import from types.ts) - status.ts: typed StatusOverview interface, remove as-any casts - snapshot-manager.ts: align observations param with SessionSnapshot type - session.ts: proper type mapping for observations (no double cast) - activity-log.ts: min-length guard for SHA prefix match - e2e tests: use top-level imports instead of inline require() - commands.test.ts: add assertions for DoctorCommand, IssuePlanCommand, IssueListCommand * fix: address review feedback from CodeRabbit and Devin - Include test step in no-checklist fallback when includeTests is true - Restore observations from snapshot in SessionSnapshotRestoreCommand * fix: address remaining CodeRabbit and Devin review feedback - doctor.ts: Use getAdapter() per AgentType instead of getAllAdapters() spread (which destroys prototype methods like isDetected) - doctor.ts: Use getGlobalSkillsDir() from AGENT_CONFIG instead of hardcoded path formula - session-explainer.ts: Defensively default state.history and state.decisions to empty arrays - session-explainer.ts: Use loadConfig().agent with skillSource fallback instead of always using skillSource as agent name - observation-store.ts: Add static readAll() that reads observations without sessionId mismatch clearing - session.ts: Use ObservationStore.readAll() for snapshot save to avoid empty observations due to sessionId mismatch
This commit is contained in:
@@ -343,6 +343,41 @@ skillkit serve --cache-ttl 3600000
|
||||
| GET | `/health` | Server health |
|
||||
| GET | `/cache/stats` | Cache statistics |
|
||||
|
||||
## Issue Planner
|
||||
|
||||
Generate structured plans from GitHub Issues. Requires the `gh` CLI.
|
||||
|
||||
```bash
|
||||
skillkit issue plan "#42" # Plan from current repo
|
||||
skillkit issue plan rohitg00/skillkit#42 # Cross-repo
|
||||
skillkit issue plan "#42" --agent cursor # Target specific agent
|
||||
skillkit issue plan "#42" --no-tests # Skip test steps
|
||||
skillkit issue plan "#42" --json # JSON output
|
||||
skillkit issue plan "#42" --tech-stack react,ts # Override tech stack
|
||||
```
|
||||
|
||||
### Issue Plan Options
|
||||
|
||||
| Option | Short | Default | Purpose |
|
||||
|--------|-------|---------|---------|
|
||||
| `--agent` | `-a` | `claude-code` | Target agent |
|
||||
| `--output` | `-o` | `.skillkit/plans/issue-<n>.md` | Output file path |
|
||||
| `--no-tests` | — | `false` | Skip test steps |
|
||||
| `--json` | — | `false` | Output as JSON |
|
||||
| `--tech-stack` | — | — | Comma-separated tech stack |
|
||||
|
||||
### Issue List
|
||||
|
||||
```bash
|
||||
skillkit issue list # List open issues
|
||||
skillkit issue list --repo owner/repo # Specific repo
|
||||
skillkit issue list --label bug # Filter by label
|
||||
skillkit issue list --limit 20 # More results
|
||||
skillkit issue list --json # JSON output
|
||||
```
|
||||
|
||||
The planner extracts task lists (checkboxes) from the issue body, infers file mentions from backtick-quoted paths, and maps labels to tags (e.g., `bug` → `fix`, `enhancement` → `feature`). Generated plans work with `skillkit plan validate` and `skillkit plan execute`.
|
||||
|
||||
## Utility Commands
|
||||
|
||||
```bash
|
||||
|
||||
@@ -93,6 +93,17 @@ const COMMAND_GROUPS: CommandGroup[] = [
|
||||
{ cmd: 'validate', desc: 'Validate format' },
|
||||
],
|
||||
},
|
||||
{
|
||||
name: 'Issues',
|
||||
commands: [
|
||||
{ cmd: 'issue plan "#42"', desc: 'Plan from issue' },
|
||||
{ cmd: 'issue plan owner/repo#42', desc: 'Cross-repo plan' },
|
||||
{ cmd: 'issue plan "#42" --agent cursor', desc: 'Target agent' },
|
||||
{ cmd: 'issue plan "#42" --json', desc: 'JSON output' },
|
||||
{ cmd: 'issue list', desc: 'List open issues' },
|
||||
{ cmd: 'issue list --label bug', desc: 'Filter by label' },
|
||||
],
|
||||
},
|
||||
{
|
||||
name: 'Advanced',
|
||||
commands: [
|
||||
|
||||
Reference in New Issue
Block a user