用途:指导撰写清晰、简洁、结构良好的技术工单,适用于 GitHub issue、PR 描述、技术文档及重构或迁移任务说明。
主要能力:
- 统一采用 What/Why/How 三段式结构。What 用 1-3 句描述主题;Why 说明背景与动机;How 列出具体步骤或方案。
- 写作风格要求积极正向措辞、中性事实语气,避免夸张和负面表述。
- 提供 Markdown 格式规范:标题、链接、列表、代码块、强调等写法。
- 指导引用官方文档、相关 issue/PR 与示例链接。
- 附带代理优化命令,如 gh issue list、gh issue view N、gh issue create、gh search issues、查看 PR 模板等。
- 与 Git 提交、分支 PR、发布变更日志、GitHub Actions 等工作流配合。
使用方式:以技能文件形式安装于 ~/.claude/skills/ticket-drafting-guidelines/。撰写工单时先了解上下文、找出相关文档与 issue,再按 What/Why/How 组织内容,保持简洁并附链接,写完后校验链接与 Markdown 渲染。
适用场景:GitHub issue、bug 报告、功能请求、PR 描述、重构任务、迁移计划。格式化 Google Chat 消息时应改用 google-chat-formatting;GitHub issue 标题格式与模板本身使用 git-plugin:github-issue-writing。
限制:文档未提供具体收费、平台支持范围或量化效果;安装命令仅提及 chezmoi apply,其余细节暂未提供。