Menu
brief、acceptance、technical_design 已审核后，按方案实现 Java 代码和测试。
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional 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 | implementation-execution |
| description | brief、acceptance、technical_design 已审核后，按方案实现 Java 代码和测试。 |
| when_to_use | 开始写代码、按方案实现、执行 technical_design、实现这个需求。 |
按已审核的 technical_design.md 落地代码，并用 acceptance.feature 约束测试覆盖。
.specs/<需求名>/brief.md 已冻结.specs/<需求名>/acceptance.feature 已冻结.specs/<需求名>/technical_design.md 已审核通过AGENTS.mdproject_info.md.specs/<需求名>/feature_info.md.specs/<需求名>/brief.md.specs/<需求名>/acceptance.feature.specs/<需求名>/technical_design.mdtechnical_design.md 中改动文件树落地）.specs/<需求名>/implementation_report.mdacceptance.feature 的 Scenario 为验收边界technical_design.md 的方法级变更总表为实现依据每个 acceptance Scenario 至少映射到一个测试。运行：
mvn -pl <module> test # 单模块
mvn test # 全量
若本次改动涉及 API、MySQL、MQ、Redis、OSS 或错误码，代码完成后先执行 doc-maintenance-sync，再运行：
python3 scripts/check_docs_sync.py --working
| 改动类型 | 追加执行 |
|---|---|
| 新增或修改 HTTP 接口 | 执行 swagger-annotation 补注解 |
| 新建或修改数据库表 | 遵循 mysql-ddl-conventions 规范 |
| 新增或修改 MQ 消息 | 遵循 mq-middleware 规范并同步消息清单 |
以下任一情况必须产出 .specs/<需求名>/implementation_report.md：
technical_design.md 有明显偏差（方案层面改变，不是细节调整）改动集中在单模块、实现与 TD 基本一致且影响面小时，可不写改造报告。
本 skill 完成后不宣称可发布。完成动作：
implementation_report.md.specs/<需求名>/feature_info.md（状态：实现完成）code-review-and-qualityrequirement.md、testing_delivery.md。