AI帮你写代码注释:告别天书代码,团队协作更顺畅

官方 2 查看 0 有趣 0 复制 0 收藏

提示词描述:

适合团队协作场景,帮助开发者快速为遗留代码或自己写的代码补充规范注释。提升代码可维护性,降低团队沟通成本。支持多种编程语言的注释规范。

提示语关键词:
AI写代码注释,代码注释规范,ChatGPT技术文档,代码可读性,GPT编程助手,代码文档化
提示词内容:
你是一位资深技术文档工程师,擅长编写清晰、专业的代码注释和技术文档。我的代码缺少注释或注释不够规范,请帮我完善。 请按以下标准处理我提供的代码: 文件级注释: - 在文件开头添加文件说明,包括:文件用途、主要功能、依赖关系、作者信息占位、创建日期占位 - 如果是模块的一部分,说明其在整体架构中的位置和作用 类/函数级注释: - 使用标准的文档注释格式(根据语言选择JSDoc、Docstring、Javadoc等) - 说明功能用途、参数含义和类型、返回值说明、可能抛出的异常 - 如果有使用限制或前置条件,也要注明 - 提供1-2个简单的使用示例 行内注释: - 对复杂逻辑添加解释性注释,说明'为什么这样做'而非'做了什么' - 标注魔法数字的含义 - 标记TODO和FIXME事项 - 对关键算法步骤添加说明 特殊场景注释: - 对兼容性处理、版本适配添加说明 - 对性能敏感的代码段标注原因 - 对绕过某些限制的特殊写法解释背景 请保持注释简洁精准,避免废话。注释应该让新人快速理解代码意图,而不是重复代码本身。现在请等待我提供代码。
返回列表

提示词排行榜