所有命令 · lifecycle
pm update
Update item fields and metadata.
Mutates existing item fields while preserving history and lock safety.
用法
pm update [options] [command] <id>参数
| <id> | Item id | 必填 |
|---|
选项
| --title, -t <value> | Set title | 可选 |
|---|---|---|
| --description, -d <value> | Set description | 可选 |
| --body, -b <value> | Set body (allow empty string) | 可选 |
| --status, -s <value> | Set status (use close command for closed) | 可选 |
| --close-reason <value> | Set close reason | 可选 |
| --priority, -p <value> | Set priority | 可选 |
| --type <value> | Set type | 可选 |
| --tags <value> | Set comma-separated tags (replaces existing). Use --add-tags / --remove-tags to mutate additively. | 可选 |
| --add-tags <value> | Add tags to the existing list without replacing it (repeatable; CSV accepted) | 可选 |
| --remove-tags <value> | Remove tags from the existing list (repeatable; CSV accepted) | 可选 |
| --deadline <value> | Set deadline (ISO/date string or relative) | 可选 |
| --estimate, --estimated-minutes <value> | Set estimated minutes | 可选 |
| --acceptance-criteria <value> | Replace the complete acceptance-criteria list (repeatable values join with '; '); use --remove-ac plus --add-ac for one-entry repair | 可选 |
| --add-ac <value> | Add one semicolon-free acceptance criterion without replacing the existing list (repeatable) | 可选 |
| --remove-ac <value> | Remove one semicolon-free acceptance criterion by exact text match; fails if any selector is unmatched (repeatable) | 可选 |
| --definition-of-ready <value> | Set definition of ready | 可选 |
| --order <value> | Set planning order/rank integer | 可选 |
| --goal <value> | Set goal identifier | 可选 |
| --objective <value> | Set objective identifier | 可选 |
| --value <value> | Set business value summary | 可选 |
| --impact <value> | Set business impact summary | 可选 |
| --outcome <value> | Set expected outcome summary | 可选 |
| --why-now <value> | Set why-now rationale | 可选 |
| --author <value> | Mutation author | 可选 |
| --message <value> | Mutation message | 可选 |
| --assignee <value> | Set assignee | 可选 |
| --parent <value> | Set parent item ID | 可选 |
| --allow-missing-parent | Allow updating to an unresolved parent reference and emit a validation warning | 可选 |
| --allow-unresolved-deps | Allow unresolved local dependency targets and emit explicit warning receipts | 可选 |
| --completed-at <value> | Correct the actual completion timestamp on a terminal item | 可选 |
| --reviewer <value> | Set reviewer | 可选 |
| --risk <value> | Set risk level: low|med|medium|high|critical (med persists as medium) | 可选 |
| --confidence <value> | Set confidence level: 0..100|low|med|medium|high (med persists as medium) | 可选 |
| --sprint <value> | Set sprint identifier | 可选 |
| --release <value> | Set release identifier | 可选 |
| --blocked-by <value> | Set latest blocked-by item ID or reason; resolved item IDs append a blocked_by dependency edge | 可选 |
| --blocked-reason <value> | Set blocked reason | 可选 |
| --unblock-note <value> | Set unblock rationale note | 可选 |
| --reporter <value> | Set issue reporter | 可选 |
| --severity <value> | Set issue severity: low|med|medium|high|critical (med persists as medium) | 可选 |
| --environment <value> | Set issue environment context | 可选 |
| --repro-steps <value> | Set issue reproduction steps | 可选 |
| --resolution <value> | Set issue resolution summary | 可选 |
| --expected-result <value> | Set issue expected behavior | 可选 |
| --expected <value> | Short alias for --expected-result | 可选 |
| --actual-result <value> | Set issue observed behavior | 可选 |
| --actual <value> | Short alias for --actual-result | 可选 |
| --affected-version <value> | Set affected version identifier | 可选 |
| --fixed-version <value> | Set fixed version identifier | 可选 |
| --component <value> | Set issue component ownership | 可选 |
| --regression [value] | Set regression marker; bare flag means true, or pass true|false|1|0 | 可选 |
| --customer-impact <value> | Set customer impact summary | 可选 |
| --dep <value> | Add dependency entries id=<id>,kind=<value>,author=<value>,created_at=<iso|now>,source_kind=<value> (repeatable) | 可选 |
| --dep-remove <value> | Remove by dependency id or exact row signature (repeatable) | 可选 |
| --comment <value> | Append comment seed author=<value>,created_at=<iso|now>,text=<value> (also accepts markdown pairs and - for stdin; repeatable) | 可选 |
| --note <value> | Append note seed author=<value>,created_at=<iso|now>,text=<value> (also accepts markdown pairs and - for stdin; repeatable) | 可选 |
| --learning <value> | Append learning seed author=<value>,created_at=<iso|now>,text=<value> (also accepts markdown pairs and - for stdin; repeatable) | 可选 |
| --file <value> | Append linked file path=<value>,scope=<project|global>,note=<text> (also accepts markdown pairs and - for stdin; repeatable) | 可选 |
| --test <value> | Append test command=<value>,path=<value>,scope=<project|global>,timeout_seconds=<n>,pm_context_mode=<schema|tracker|auto|none> (also accepts markdown pairs and - for stdin; repeatable) | 可选 |
| --doc <value> | Append linked doc path=<value>,scope=<project|global>,note=<text> (also accepts markdown pairs and - for stdin; repeatable) | 可选 |
| --reminder <value> | Set reminders at=<iso|relative>,text=<text> (also accepts markdown pairs and - for stdin; repeatable) | 可选 |
| --event <value> | Set events 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) | 可选 |
| --type-option <value> | Set type options key=value or key=<name>,value=<value> (also accepts key:value and markdown pairs; use - for stdin; repeatable) | 可选 |
| --field <name=value> | Set a field declared by an active extension registerItemFields registration (repeatable) | 可选 |
| --unset <field> | Clear scalar metadata field by name (repeatable) | 可选 |
| --stdin-json | Read a full item JSON document from stdin; explicit flags override document values | 可选 |
| --body-file <path> | Load body from a file or stdin (-); conflicts with --body | 可选 |
| --replace-deps | Atomically replace dependency entries with the provided --dep values | 可选 |
| --replace-tests | Atomically replace linked test entries with the provided --test values | 可选 |
| --replace-files | Atomically replace linked file entries with the provided --file values | 可选 |
| --replace-docs | Atomically replace linked doc entries with the provided --doc values | 可选 |
| --clear-deps | Clear dependency entries | 可选 |
| --clear-comments | Clear comments | 可选 |
| --clear-notes | Clear notes | 可选 |
| --clear-learnings | Clear learnings | 可选 |
| --clear-files | Clear linked files | 可选 |
| --clear-tests | Clear linked tests | 可选 |
| --clear-docs | Clear linked docs | 可选 |
| --clear-reminders | Clear reminders | 可选 |
| --clear-events | Clear events | 可选 |
| --clear-type-options | Clear type options | 可选 |
| --force | Force ownership override | 可选 |
示例
pm update pm-a1b2 --status in_progress --message "Start implementation"