Plan

Agent Skills › stagewise-io/stagewise › Plan

GitHub

在编码前创建结构化的实施计划。通过研究代码、澄清歧义并生成包含详细任务列表的 Markdown 文件，确保代理在用户批准后才开始实现，旨在提高开发过程的条理性和准确性。

apps/browser/bundled/skills/plan/SKILL.md stagewise-io/stagewise

Trigger Scenarios

需要规划复杂功能实现执行多步骤重构任务

Install

npx skills add stagewise-io/stagewise --skill Plan -g -y

More Options

Non-standard path

npx skills add https://github.com/stagewise-io/stagewise/tree/main/apps/browser/bundled/skills/plan -g -y

Use without installing

npx skills use stagewise-io/stagewise@Plan

指定 Agent (Claude Code)

npx skills add stagewise-io/stagewise --skill Plan -a claude-code -g -y

安装 repo 全部 skill

npx skills add stagewise-io/stagewise --all -g -y

预览 repo 内 skill

npx skills add stagewise-io/stagewise --list

SKILL.md

Frontmatter

{
    "name": "Plan",
    "description": "Create a structured implementation plan before coding",
    "user-invocable": true,
    "agent-invocable": false
}

You must create a structured implementation plan. Follow these instructions:

Workflow

Research — read all affected files, trace data flow, understand the full change surface.
Clarify — if genuinely ambiguous, batch questions into one askUserQuestions call.
Write — create a kebab-case .md in plans/.
Stop — present a summary and wait for approval. Do NOT implement until the user confirms.

Plan File Spec

Line 1: # Plan Title (h1) — used as display name in UI.
Line 2: One-sentence plain-text description — used as summary in UI.
Body: Freeform markdown. Use whatever sections best explain the change — Problem, Approach, Context, Changes, File Map, Key Details, etc. No fixed structure required; scale detail to complexity. Do not use emojis.
- Self-contained: A fresh agent with no prior context should be able to implement the plan without re-researching the codebase. Include relevant file paths (mount-prefixed, e.g. w4ba9/src/...), current behavior, key decisions and rationale in prose sections. Omit sections that add no value.
- Checkboxes: Use GFM checkboxes (- [ ]) for tasks. See Checkbox Rules below.

Checkbox Rules

Every checkbox = one concrete, completable work item.

Agent-completable only — every checkbox MUST be doable by you alone with your own tools. Never write tasks that require the user to act (manual testing, running commands in their shell, restarting a dev server, exporting env vars, reviewing, clicking through a UI, obtaining credentials, etc.). If such work is genuinely needed, describe it in a prose ## Follow-ups for the user section — never as a checkbox.
Short label — the - [ ] line is a concise, scannable summary (one sentence). It says what to do, not how.
Details below — implementation specifics (file paths, code snippets, sub-steps) go in indented content underneath the checkbox line. Never cram these into the checkbox line itself.
No alternatives — resolve choices in prose above, then write one task for the chosen approach.
No optional/decorative items — if conditional, resolve the condition; include as firm task or omit.
Parent-child consistency — parent is complete only when all children are complete.

Example

# Rename Commands to Skills

Rename all "command" terminology to "skill" across shared types, backend, and UI.

## Context

The codebase currently uses "command" (`CommandDefinition`, `CommandSource`, etc.) but the
user-facing terminology has shifted to "skill". The rename touches 3 files and 6 import sites.

## Tasks

- [ ] Rename `CommandDefinition` type and its source file

  Rename `w4ba9/src/shared/commands.ts` → `skills.ts`. Inside the file:
  - `CommandSource` → `SkillSource`
  - `CommandDefinition` → `SkillDefinition`
  - `toCommandDefinitionUI` → `toSkillDefinitionUI`

  Update all 6 import sites listed in the Context section.

- [ ] Update Karton state key from `commands` to `skills`

  In `w4ba9/src/shared/karton-contracts/ui/index.ts` (line ~629),
  change the state key and update the JSDoc comment above it.

- [ ] Verify typecheck passes

  Run `pnpm -F stagewise typecheck` for both `tsconfig.ui.json` and `tsconfig.backend.json`.