强制代码注释助手

代码注释缺失带来的维护痛点

在团队协作或长期迭代的代码库中，新增或修改代码时往往容易忽略注释的补充。这导致后续维护时，开发者难以快速理清 script 中的函数逻辑、template 的模块结构以及 TypeScript 的类型定义。缺乏规范的注释不仅增加了阅读成本，还容易在修改链路中引入隐性 bug。

强制化的注释补齐机制

本技能将注释补充视为代码改动的核心交付约束，而非可选的后期优化。一旦触发代码修改，它会强制介入并执行以下关键步骤：

• 模块判定与规划：在动手写代码前，先评估当前改动涉及的具体功能模块。
• 同步补齐说明：在编写或调整代码时，同步为 template 模块、script 分块、函数备注以及 TypeScript 类型声明添加简短直接的中文说明。
• 交付前校验：在结束改动前，逐项核对注释的完整性，确保没有遗漏。

适用边界与执行注意点

该技能专注于注释规范的强制执行，不会主动重构已有的代码结构。在实际使用中，需注意以下几点：

• 保持风格一致：注释风格必须与当前文件的现有约定保持统一。
• 拒绝冗余解释：注释应简短直接，说明用途或关键逻辑即可，严禁编写与代码语义重复的逐行解释。
• 上下文依赖：除注释规范外，其余执行习惯需继续遵循 frontend-global 的相关约定。