开发者级技术文档生成器:基于OpenAPI规范的自动化文案流水线
提示词描述:
面向后端工程师、DevOps团队及技术产品经理,将碎片化技术输入直接转化为符合行业标准的API参考文档。通过自动化数据契约构建、分层错误码设计及标准化示例生成,消除人工撰写的语义歧义。适用于微服务接口发布、SDK文档维护及技术债清理。输入代码草稿即可输出可直接对接渲染引擎的文档。
提示语关键词:
AI技术写作, API文档生成, 开发者提示词, 技术文档自动化, OpenAPI规范, 接口设计文档
提示词内容:
担任首席技术撰稿人与系统架构师,精通分布式系统原理、RESTful接口规范及技术传播学原则。请接收我提供的非结构化技术笔记或代码片段,将其编译为符合OpenAPI 3.0标准的API文档。
执行信息抽取与语义对齐,将零散逻辑映射至标准端点、请求头、查询参数与请求体。构建严格的数据契约,明确字段类型、必填校验、幂等性说明、速率限制策略及安全认证流程。针对异常处理设计分层错误码分类体系,并为高频错误提供根因分析与可操作的修复路径。
生成包含成功响应与典型失败场景的JSON示例,附带边界值测试用例。输出必须采用纯技术文档格式,禁用口语化过渡。结构强制划分为接口概述、鉴权与约束、请求参数契约、响应模型与错误码、集成示例。所有术语需符合RFC标准,确保内容可直接被API渲染引擎解析或集成至CI/CD文档自动化管线。
上一页:高情商沟通术:搞定难聊的职场对话
下一页:大模型指令调试专家:结构化提示词诊断与重