所有命令 · graph
pm plan
Agent-optimized Plan item workflow: create, manage steps, link dependencies, approve, and materialize.
Agent-optimized Plan item workflow: create, manage steps, link dependencies, approve, and materialize.
用法
pm plan [options] <subcommand> [id] [step] [new-order]参数
| <subcommand> | Required; Plan subcommand: create|show|add-step|update-step|complete-step|block-step|reorder-step|remove-step|link|unlink|decision|discovery|validation|resume|approve|materialize | 必填 |
|---|---|---|
| <id> | Plan id (required for non-create subcommands); for create this may be the positional title | 可选 |
| <step> | Step reference: stable id (plan-step-001) or order integer | 可选 |
| <new-order> | New order integer for reorder-step | 可选 |
选项
| --title <value> | Plan title | 可选 |
|---|---|---|
| --description <value> | Plan description | 可选 |
| --scope <value> | Short scope statement of the target change or investigation | 可选 |
| --parent <value> | Parent pm item id | 可选 |
| --related <value> | Related pm item ids (repeatable, csv-friendly) | 可选 |
| --blocks <value> | Pm item ids this plan blocks (repeatable, csv-friendly) | 可选 |
| --blocked-by <value> | Pm item ids that block this plan (repeatable, csv-friendly) | 可选 |
| --harness <value> | Plan harness provenance: codex|claude-code|cursor|generic | 可选 |
| --mode <value> | Plan mode: draft|research|review|approved|executing|paused|completed|superseded | 可选 |
| --resume-context <value> | Compact context summary for a future stateless agent | 可选 |
| --tags <value> | Comma-separated tags | 可选 |
| --priority <value> | Priority 0-4 | 可选 |
| --body <value> | Plan item body | 可选 |
| --claim | Claim the plan on create for the author | 可选 |
| --from-search <value> | Record the search query that led to plan creation | 可选 |
| --template <value> | Seed plan steps from a built-in template: bug-investigation|feature-implementation|refactoring-sprint | 可选 |
| --step-title <value> | Step title for add-step / update-step | 可选 |
| --step <value> | Step title (repeatable on create: each --step appends an ordered step; elsewhere a single value aliases --step-title) | 可选 |
| --step-body <value> | Step body text | 可选 |
| --step-owner <value> | Step owner | 可选 |
| --step-status <value> | Step status: pending|in_progress|completed|blocked|skipped|superseded | 可选 |
| --step-evidence <value> | Step evidence text (used by update-step/complete-step) | 可选 |
| --step-blocked-reason <value> | Step blocked reason (required when blocking) | 可选 |
| --step-replacement <value> | Replacement reference for a superseded step | 可选 |
| --depends-on <value> | Pm item ids the step depends on (repeatable, csv-friendly) | 可选 |
| --link <value> | Pm item id to link (repeatable, csv-friendly) | 可选 |
| --link-kind <value> | Link kind: related|blocks|blocked_by|depends_on|discovered_from|implements|recurs_from|verifies|supersedes | 可选 |
| --link-note <value> | Optional note for the link | 可选 |
| --promote-to-item-dep | Also add the linked id as a top-level item dependency when linking | 可选 |
| --allow-multiple-active | Allow multiple steps to be in_progress at once | 可选 |
| --file <value> | Step linked file path=<value>[,scope=project|global,note=<text>] (repeatable) | 可选 |
| --test <value> | Step linked test command=<value>[,path=<value>,note=<text>] (repeatable) | 可选 |
| --doc <value> | Step linked doc path=<value>[,scope=project|global,note=<text>] (repeatable) | 可选 |
| --decision-text <value> | Decision log entry text | 可选 |
| --decision-rationale <value> | Decision log entry rationale | 可选 |
| --decision-evidence <value> | Decision log entry evidence | 可选 |
| --discovery-text <value> | Discovery log entry text | 可选 |
| --validation-text <value> | Validation log entry text | 可选 |
| --validation-command <value> | Validation log entry command | 可选 |
| --validation-expected <value> | Validation log entry expected outcome | 可选 |
| --depth <value> | Show depth: brief|standard|deep (default: brief) | 可选 |
| --fields <value> | Comma-separated field projection for show output | 可选 |
| --steps <value> | Comma-separated step ids/orders for materialize | 可选 |
| --materialize-type <value> | Item type for materialized steps (default: Task) | 可选 |
| --materialize-parent <value> | Parent item id for materialized children (default: the plan) | 可选 |
| --materialize-tags <value> | Comma-separated tags for materialized children | 可选 |
| --field <name=value> | Custom field value forwarded to every materialized child (repeatable) | 可选 |
| --author <value> | Mutation author | 可选 |
| --message <value> | Mutation message | 可选 |
| --force | Force ownership override | 可选 |
| --create-mode <value> | Create required-option policy mode: strict|progressive | 可选 |
| --status, -s <value> | Item status | 可选 |
| --deadline <value> | Deadline (ISO/date string or relative +6h/+1d/+2w/+6m) | 可选 |
| --estimate, --estimated-minutes <value> | Estimated minutes | 可选 |
| --acceptance-criteria <value> | Acceptance criteria (repeatable; values join with '; '; allow empty string) | 可选 |
| --definition-of-ready <value> | Definition of ready (allow empty string) | 可选 |
| --order <value> | Planning order/rank integer | 可选 |
| --goal <value> | Goal identifier | 可选 |
| --objective <value> | Objective identifier | 可选 |
| --value <value> | Business value summary | 可选 |
| --impact <value> | Business impact summary | 可选 |
| --outcome <value> | Expected outcome summary | 可选 |
| --why-now <value> | Why-now rationale | 可选 |
| --assignee <value> | Item assignee | 可选 |
| --reviewer <value> | Reviewer | 可选 |
| --risk <value> | Risk level: low|med|medium|high|critical (med persists as medium) | 可选 |
| --confidence <value> | Confidence level: 0..100|low|med|medium|high (med persists as medium) | 可选 |
| --sprint <value> | Sprint identifier | 可选 |
| --release <value> | Release identifier | 可选 |
| --blocked-reason <value> | Blocked reason | 可选 |
| --unblock-note <value> | Unblock rationale note | 可选 |
| --reporter <value> | Issue reporter | 可选 |
| --severity <value> | Issue severity: low|med|medium|high|critical (med persists as medium) | 可选 |
| --environment <value> | Issue environment context | 可选 |
| --repro-steps <value> | Issue reproduction steps | 可选 |
| --resolution <value> | Issue resolution summary | 可选 |
| --expected-result <value> | Issue expected behavior | 可选 |
| --expected <value> | Short alias for --expected-result | 可选 |
| --actual-result <value> | Issue observed behavior | 可选 |
| --actual <value> | Short alias for --actual-result | 可选 |
| --affected-version <value> | Affected version identifier | 可选 |
| --fixed-version <value> | Fixed version identifier | 可选 |
| --component <value> | Issue component ownership | 可选 |
| --regression [value] | Regression marker; bare flag means true, or pass true|false|1|0 | 可选 |
| --customer-impact <value> | Customer impact summary | 可选 |
| --type-option <value> | Type option key=value or key=<name>,value=<value> (also accepts key:value and markdown pairs; use - for stdin; repeatable) | 可选 |
| --reminder <value> | Seed reminder entry at=<iso|relative>,text=<text> (also accepts markdown pairs and - for stdin; repeatable) | 可选 |
| --event <value> | Seed event entry start=<iso|relative>,end=<iso|relative>,duration=<relative|30min|PT30M>,title=<text>,all_day=<true|false>,recur_* fields (also accepts markdown pairs and - for stdin; repeatable) | 可选 |
| --comment <value> | Seed comment entry (text=<value> CSV/markdown pairs or - for stdin; repeatable) | 可选 |
| --note <value> | Seed note entry (text=<value> CSV/markdown pairs or - for stdin; repeatable) | 可选 |
| --learning <value> | Seed learning entry (text=<value> CSV/markdown pairs or - for stdin; repeatable) | 可选 |
示例
pm plan --help