技术文档与注释

把模型设定为一位有15年经验、以严苛著称的首席架构师，对用户提交的架构设计文档做逐条质询式评审，输出评审意见清单与必须回答的追问清单。

针对一段已有注释的代码，删除复述型注释、补齐决策型注释，产出可直接提交的注释补丁与理由说明。

把已有 API 文档在语义完全不变的前提下，按「一句话摘要 + 参数表 + 示例 + 错误码 + 备注」重排，显著降低读者定位成本。

输入一段无注释的源码，产出符合指定风格规范的可运行注释版代码，并附注释清单与遗留疑点。

面向被指派写文档但不知从何下手的开发者，基于其具体处境（文档类型、读者、已有材料、时间预算）给出分步可落地的写作方案、决策依据与常见坑。

面向开发者在本地/测试环境遇到的编译、运行、单测报错，输出「堆栈逐帧解读 + 最小复现 + 补丁 diff + 边界用例」，强调先复现再修。

对同一段代码，从六种不同读者视角分别生成注释草案，帮助团队发现注释盲区并挑选最合适的写法。

为同一篇技术文档批量生成风格各异的标题/章节命名方案，按风格分组并附取舍建议，解决文档命名千篇一律的问题。

把源码里的中文注释改写为目标语言的规范注释块（JSDoc / docstring / Javadoc），补齐参数、返回值、异常说明，并输出改动对照表。

把中文 API 参考文档整段翻译成英文（或反向），严格套用给定术语表，输出译文 + 术语命中报告 + 待确认术语清单三部分。

面向架构师/技术负责人，把候选方案按统一维度打分成矩阵，并输出「如果…就选…」的条件化推荐与不达标红线。

把散落在需求文档、邮件或聊天记录里的接口描述，抽取成结构化参数表（含字段名、类型、必填、约束、示例），并输出为可校验的 JSON 数组，供后续生成 OpenAPI 片段。

面向技术文档负责人，针对现有文档散乱、缺失、过期等问题，产出分阶段建设路线图：阶段目标、里程碑验收标准、人力工时估算与风险预案，输出为可直接进周会的表格化计划。

以「下一位维护者」视角审查代码注释与 README，输出按文件行号定位的挑错清单与补写建议。

面向一线开发者，把一段代码与其注释/文档字符串对照审计，找出注释说谎、注释缺失、注释冗余三类问题，并给出可直接替换的注释文本。

面向后端/平台工程师，对一份 API 文档做可读性与完整性诊断，输出问题清单、成因、风险等级与判断依据，并给出最小改动建议。

面向 README、模块注释、接口文档这类半结构化材料，输出“能直接贴进发布说明或新人 onboarding”的要点清单，并标注每条适用范围与前提条件。

把冗长的技术方案/评审材料压缩成一页决策纪要：结论先行、待办可指派、风险与未决问题单列，并给出原文定位。

把复述代码的字面注释改写成解释「为什么」的意图型注释，按团队规范统一语言、时态与标签格式，并标出应删除的冗余注释。

把内部草稿式的接口说明改写成面向外部调用方的参考文档：统一第二人称、补齐前置条件与返回值语义，输出可直接粘进文档站的结构化 Markdown。

输入一段源码，产出参数、返回值、异常、副作用的完整注释块，并附一段可放进文档站的用法说明与示例。

让模型扮演刚接手该模块的资深工程师，仅凭现有技术文档去理解系统，把读不懂的地方变成一轮轮追问，暴露文档的缺失与歧义。

给一份接口或流程说明，产出一个能直接跑的脚本、依赖清单、运行示例和故障排查表。

当团队对某段代码该不该加注释、注释写到什么粒度产生分歧时，由资深维护者视角给出裁决结论、理由与可执行的注释规范片段。