LinkRag-Service

当用户要求基于某个需求、功能、改造、技术方案或项目实践生成博客文章时使用；必须结合用户给出的完整需求、当前项目真实实现逻辑、业务场景和代码/文档上下文做深入分析，输出通俗易懂且专业的 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 请求，断言响应，最终在对话中返回测试结果汇总。

实现完成后，从当前改动创建规范分支、提交并发起 PR。

brief.md 已冻结后，基于 brief 生成 Gherkin 验收契约 .specs/<需求名>/acceptance.feature。

当仓库内创建、删除、移动、重命名源码模块、脚本、配置、测试或 Agent/Skill 等核心项目目录，并且这些变更影响项目结构展示时，要求同步更新 AGENTS.md（= .ai/prompts/project.md）中的"当前项目结构"树。docs 目录下任何文件或目录结构变化都不触发本 skill。

用户提出新需求、重构想法、业务分析、先写 brief 或需要理清影响模块时使用；产出 .specs/<需求名>/brief.md，并支持迭代到冻结。

实现和测试完成后，提交或合并前执行质量门禁。

检查 API、MySQL、Redis、MQ、OSS、错误码等跨模块或跨系统契约是否被影响。

当用户要提 issue、登记 bug、记录新需求时使用；自动识别所属项目，生成结构化 issue 内容，先在 Linear 建主记录、再在 GitHub 建镜像，并双向回链。用户说"提个 issue""记一下这个 bug""把这个需求登记一下""同步到 Linear 和 GitHub""别再依赖 Linear 自动同步"时都应触发，即使没有明确说出"Linear"或"GitHub"。

brief、acceptance、technical_design 已审核后，按方案实现 Java 代码和测试。

当用户明确只需要 GitHub issue，或 Linear 不可用且接受降级时，生成规范的 GitHub issue 并通过 gh 创建。

指导如何使用 toLink-Service 的 MQ 消息中台进行消息收发、定义新消息类型以及处理多厂商适配逻辑。

当用户提出想根据某个需求、工作流、角色职责或项目约定创建一个全新的 Agent skill 时使用；先深度理解用户目标、触发场景、输入输出、执行边界和质量标准，在需求不清时主动追问，最终生成结构清晰、触发准确、流程可执行、可维护的 `.ai/skills/<skill-name>/SKILL.md`。

当用户要求优化、重写、评审、增强或规范化已有 Agent skill 时使用；以专业提示词工程师视角先理解目标和使用场景，识别不确定需求并主动提问，在关键需求未确认前不得直接修改 skill，确认后产出高质量、可触发、可执行、可维护的 SKILL.md。

为 toLink-Service 生成或修复 JUnit、Mockito、MockMvc、SpringBootTest 测试。

运行 toLink-Service 全量 Maven 测试并报告结果。

用户明确要求 TDD、先写测试、红绿重构时使用。