메뉴
当用户明确只需要 GitHub issue，或 Linear 不可用且接受降级时，生成规范的 GitHub issue 并通过 gh 创建。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
当用户要求基于某个需求、功能、改造、技术方案或项目实践生成博客文章时使用；必须结合用户给出的完整需求、当前项目真实实现逻辑、业务场景和代码/文档上下文做深入分析，输出通俗易懂且专业的 Markdown 博客到 `.specs/blog/《博客名称》.md`。
当修改 AGENTS.md/CLAUDE.md、docs/api、docs/internals、docs/ops，或代码变更影响这些文档记录的 API、MySQL schema、MQ 契约、Redis 缓存、OSS、错误码、模块架构、配置时，检查并同步更新对应文档，保证项目文档自动维护。
MySQL 建表与字段规范（面向 Java 管理端业务：用户、LLM 配置、数据集、知识文件、解析任务）。统一命名、索引、字段类型、时间戳、引擎字符集与注释要求，便于研发与 DBA 评审落地。
SpringDoc OpenAPI 3 中文注解生成工作流。为 Spring Boot Controller 和 DTO 生成符合企业级规范的中文 Swagger 注解（@Tag、@Operation、@Parameter、@Schema）。
brief.md 和 acceptance.feature 已冻结后，生成 .specs/<需求名>/technical_design.md；必须基于真实 Java 代码、组件文档和契约。
为 toLink-Service 的 HTTP 接口构建并执行全面的 curl 黑盒测试。分析待测接口与边界条件，必要时直连数据库或经接口造数，对本地已启动服务发起 curl 请求，断言响应，最终在对话中返回测试结果汇总。
| name | issue-writer |
| description | 当用户明确只需要 GitHub issue，或 Linear 不可用且接受降级时，生成规范的 GitHub issue 并通过 gh 创建。 |
| when_to_use | 发现 bug、想提 issue、记录新需求，但只想建 GitHub issue；或 Linear 不可用、用户接受只落 GitHub。若需要 Linear 与 GitHub 双向同步，转 cowork-issue-sync。 |
帮助用户快速生成规范的 GitHub issue，作为 GitHub-only fallback 使用。支持两种类型：
若当前项目要求 Linear 与 GitHub 双向同步，默认不使用本 skill，应转 cowork-issue-sync。
从用户描述判断是 bug 还是新需求。不明确时追问，不要猜。
Bug Report 需要：
Feature Request 需要：
信息不完整时从上下文补齐；关键项缺失（如 bug 无复现路径）则追问。
Bug Report 模板：
## 问题描述
<一句话>
## 复现路径
1.
2.
3.
## 预期行为
## 实际行为
## 影响范围
阻塞 / 功能异常 / 体验问题
## 相关位置
<Controller / Service / 表名 / MQ Topic 等，若已知>
Feature Request 模板：
## 背景
<为什么需要>
## 目标
<做什么>
## 不做什么
## 优先级
高 / 中 / 低
gh issue create \
--title "<标题>" \
--body "$(cat <<'EOF'
<正文>
EOF
)" \
--label "<bug 或 enhancement>"
若 gh 不可用，输出可直接复制的标题和正文。
brief-generator 分析影响范围。brief-generator 展开需求。