manage-sprint
当用户请求“创建冲刺”、“开始冲刺”、“结束冲刺”、“完成冲刺”、“关闭冲刺”、“新冲刺”、“开始冲刺”、“完成冲刺”、“更新冲刺”、“重命名冲刺”或希望创建或更改冲刺状态/详情时,必须使用此技能。
📖 中文导读:当用户请求“创建冲刺”、“开始冲刺”、“结束冲刺”、“完成冲刺”、“关闭冲刺”、“新冲刺”、“开始冲刺”、“完成冲刺”、“更新冲刺”、“重命名冲刺”或希望创建或更改冲刺状态/详情时,必须使用此技能。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: manage-sprint description: This skill MUST be used when the user asks to "create sprint", "start sprint", "end sprint", "complete sprint", "close sprint", "new sprint", "begin sprint", "finish sprint", "update sprint", "rename sprint", or otherwise wants to create or change sprint state/details.
Manage Sprint
Create, start, complete, and update sprints.
Quick Start
Use the Python script at scripts/manage_sprint.py:
# Create a new 2-week sprint
python scripts/manage_sprint.py PROJ --create "Sprint 24" --duration 14
# Create sprint with specific dates
python scripts/manage_sprint.py PROJ --create "Sprint 24" \
--start-date 2024-02-01 --end-date 2024-02-14
# Start a sprint (future -> active)
python scripts/manage_sprint.py PROJ --start --sprint-id 123
# Start the next future sprint
python scripts/manage_sprint.py PROJ --start --next
# Complete/close a sprint (active -> closed)
python scripts/manage_sprint.py PROJ --complete
# Complete specific sprint
python scripts/manage_sprint.py PROJ --complete --sprint-id 123
Actions
| Action | Description |
|---|---|
--create NAME |
Create new sprint with given name |
--start |
Start a sprint (future → active) |
--complete |
Complete a sprint (active → closed) |
--update |
Update sprint details |
Create Options
| Option | Description |
|---|---|
--create NAME |
Sprint name (required) |
--start-date DATE |
Start date (YYYY-MM-DD) |
--end-date DATE |
End date (YYYY-MM-DD) |
--duration DAYS |
Duration in days (default: 14) |
--goal TEXT |
Sprint goal |
If only --duration is provided, sprint starts tomorrow.
Start/Complete Options
| Option | Description |
|---|---|
--sprint-id ID |
Target specific sprint |
--next |
Start next future sprint |
| (none) | Start/complete uses next future / active sprint |
Update Options
| Option | Description |
|---|---|
--sprint-id ID |
Sprint to update (required) |
--name NAME |
New sprint name |
--start-date DATE |
New start date |
--end-date DATE |
New end date |
--goal TEXT |
New sprint goal |
Examples
Create and Start Sprint
# Create sprint starting tomorrow for 2 weeks
python scripts/manage_sprint.py PROJ --create "Sprint 24" --goal "Complete auth module"
# Start it immediately
python scripts/manage_sprint.py PROJ --start --next
End Current Sprint
# Complete the active sprint
python scripts/manage_sprint.py PROJ --complete
Update Sprint Details
# Rename and extend sprint
python scripts/manage_sprint.py PROJ --update --sprint-id 123 \
--name "Sprint 24 (Extended)" --end-date 2024-02-21
Output Example
Compact (default)
CREATED|456|Sprint 24|future|2024-02-01|2024-02-14
STARTED|456|Sprint 24|active
COMPLETED|456|Sprint 24|closed
Environment Setup
Requires three environment variables:
JIRA_BASE_URL- e.g.,https://yoursite.atlassian.netJIRA_EMAIL- Your Jira account emailJIRA_API_TOKEN- API token from Atlassian account settings
Permissions
Requires "Manage Sprints" permission on the project's board.
Reference
For complete options and error handling, see references/options-reference.md.