القائمة
当用户明确只需要 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 展开需求。