# Dx Devops Work Item Manage

Use this skill to manage the full lifecycle of DevOps Center work items, list, create...

- Repository: https://github.com/forcedotcom/sf-skills (1134 stars)
- Category: DevOps
- License: Apache-2.0
- Last updated: 2026-10-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add forcedotcom/sf-skills --skill dx-devops-work-item-manage -g -a claude-code -y`
Codex: `npx skills add forcedotcom/sf-skills --skill dx-devops-work-item-manage -g -a codex -y`
Cursor: `npx skills add forcedotcom/sf-skills --skill dx-devops-work-item-manage -g -a cursor -y`
Gemini CLI: `npx skills add forcedotcom/sf-skills --skill dx-devops-work-item-manage -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add forcedotcom/sf-skills`

## Description

Use this skill to manage the full lifecycle of DevOps Center work items, list, create, update, commit changes, perform status transitions, and create pull requests. Update fields like subject, description, and status. Commit changes to work item branches, through the DevOps Center commit API or git. Create pull requests for work item branches via DevOps Center API. Invoke when the user wants to track, find, create, or update a work item, commit changes to a work item branch, advance a work item's status through the pipeline, or create a pull request for code review. Consolidates sf devops work-item and review operations. DO NOT TRIGGER for promotion or deployment operations, or conflict detection.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# DevOps Center Work Item Management

Manages the complete work item lifecycle in DevOps Center, from creation through status transitions to promotion readiness. Provides headless CLI-driven operations for autonomous release workflows.

## Scope

- **In scope**: List work items, create new work items, commit changes to work item branches, update work item fields (subject, description, status), transition work item status (New → In Progress → Ready to Promote), create pull requests for work item branches
- **Out of scope**: Promotion/deployment, conflict detection, pipeline or project management (separate skills)

---

## Required Inputs

Gather or infer before proceeding:

- **Operation type**: list, create, update, commit, or create-review
- **For list**: project ID (required), obtain via `sf devops project list --json` if not provided
- **For create**: project ID (required), subject (required), description (optional)
- **For commit**: work item name or ID (required), commit message, and either the files to commit (git path) or the components to commit (API path). Optional: **dev org alias**, the org that holds the changes. When provided, try the DevOps Center commit API first (see step 5); otherwise use git
- **For update**: work item name (e.g., WI-000001) or work item ID (required), fields to update (subject, description, status)
- **For create-review**: work item name (e.g., WI-000001) or work item ID (required)

Defaults unless specified:
- Output format: `--json` for headless consumption
- Work item identifier: prefer `--work-item-name` (WI-000001) over `--work-item-id` when both are available (names are human-readable)

If the user provides a clear request ("list work items for Project Alpha", "create work item to fix login bug", "move WI-12345 to In Progress", "create PR for WI-12345"), proceed immediately without unnecessary questions.

---

## Workflow

The rest: https://github.com/forcedotcom/sf-skills/blob/HEAD/plugins/builder/dx-devops/skills/dx-devops-work-item-manage/SKILL.md