Agent Skills
› NeverSight/learn-skills.dev
› guild-ticket
guild-ticket
GitHub通过guild CLI管理工单（IDEA、BUG、STORY、SUBTASK）的创建、更新、发布及工作流。支持层级规则、状态流转、权限控制及操作执行，适用于处理项目中的缺陷、故事和子任务。
触发场景
用户询问如何创建或管理工单
涉及BUG、STORY、SUBTASK等类型的任务处理
需要执行工单的状态变更、发布或审批操作
安装
npx skills add NeverSight/learn-skills.dev --skill guild-ticket -g -y
SKILL.md
Frontmatter
{
"name": "guild-ticket",
"metadata": {
"requires": {
"bins": [
"guild"
],
"cliHelp": "guild ticket --help"
}
},
"description": "Create, update, publish, and manage Guild tickets (IDEA, BUG, STORY, SUBTASK) via the guild CLI. Use when the user asks about tickets, bugs, stories, subtasks, or ticket workflows in Guild."
}
guild-ticket
Overview
Manage tickets through guild ticket subcommands. Ticket numbers (--no) are project-scoped.
Hierarchy rules
| Type | Parent | Milestone |
|---|---|---|
| IDEA / BUG | Must be root (no parent) | Allowed on root only |
| STORY | Parent must be IDEA | Not allowed |
| SUBTASK | Parent must be STORY or BUG | Not allowed |
Typical workflow
- Create BUG or IDEA at root:
guild ticket create --type BUG --title "..." --content-file ./bug.md - Break down STORY:
guild ticket create --type STORY --parent-no <ideaNo> --title "..." - Add SUBTASK under STORY or BUG:
guild ticket create --type SUBTASK --parent-no <storyOrBugNo> --title "..." - Set level:
guild ticket set-level --no <n> --level 2 - Assign milestone (root only):
guild ticket set-milestone --no <n> --milestone-no 3 - Publish:
guild ticket publish --no <n> - Move to todo lane (creates take action):
guild ticket set-stage --no <n> --stage todo - Take / submit / approve:
guild ticket action --no <n> --name take|submit|approve|reject|untake
Publish only marks the ticket as published; you must set stage to todo before developers can take it (same as moving a card on the kanban).
Approve/reject actions are assigned to the ticket owner (usually PO), not PM.
Submit accepts an optional --pull-request-url; the repo must be bound to the project or omit the URL.
Commands
guild ticket list [--type IDEA|BUG|STORY|SUBTASK] [--status ...] --json
guild ticket get --no <n>
guild ticket create --type BUG --title "..." [--content-file path] [--parent-no <n>] [--milestone-no <n>]
guild ticket update --no <n> [--title ...] [--content-file path]
guild ticket delete --no <n>
guild ticket set-milestone --no <n> [--milestone-no <n>]
guild ticket set-level --no <n> --level <n>
guild ticket set-stage --no <n> --stage todo|doing|review|done
guild ticket set-stage --no <n> --clear
guild ticket set-iteration --no <n> [--iteration-no <n>]
guild ticket publish --no <n>
guild ticket unpublish --no <n>
guild ticket close --no <n>
guild ticket reopen --no <n>
guild ticket action --no <n> --name take|untake|submit|approve|reject [--pull-request-url ...]
Permissions (summary)
- IDEA/BUG create: project access
- STORY/SUBTASK create:
P.ticket.manage - publish / unpublish:
P.ticket.publish/P.ticket.unpublish - set-stage:
P.ticket.manage - close / reopen:
P.ticket.close - actions:
P.ticket.action
Help
When parameters are unclear, run help first:
guild ticket --help
guild ticket create --help
guild ticket action --help
Tips
- Use
--content-filefor long markdown bodies. - Use
--json(default) for machine-readable output. - Do not use internal UUIDs; always use
--no.
版本历史
- c3c0a1e 当前 2026-07-23 11:05
