菜单
为代码添加注释。当用户要求"加注释"、"添加文档注释"、"补充注释"、 "写 docstring"、"加 Javadoc"、"给模板加注释"、"给样式加注释"时触发。 不适用于：实现新功能、修改代码逻辑、删除代码，或为每行代码强制加注释。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | yy-comment |
| description | 为代码添加注释。当用户要求"加注释"、"添加文档注释"、"补充注释"、 "写 docstring"、"加 Javadoc"、"给模板加注释"、"给样式加注释"时触发。 不适用于：实现新功能、修改代码逻辑、删除代码，或为每行代码强制加注释。 |
为代码添加注释的通用技能，支持多种编程语言和标记语言。遵循跨语言通用规则，并按语言加载特定注释规范；语言特定规则与通用规则冲突时，以语言特定规则优先。
当用户表达以下意图时触发：
不应触发：
通用规则定义在 resources/common.md，语言特定规则定义在 resources/{语言}.md。
当特定语言的规则与通用规则冲突时，以特定语言的规则优先。
resources/python.mdresources/java.mdresources/c-cpp.mdresources/csharp.mdresources/go.mdresources/rust.mdresources/swift.mdresources/kotlin.mdresources/ruby.mdresources/php.mdresources/shell.mdresources/sql.mdresources/js-ts.mdresources/html-css.md遇到未列出语言的文件时，使用通用规则和该语言的注释语法常识处理。
决策分支：
git diff 查找变更文件，过滤为支持类型的文件对于超过 500 行的文件，先告知用户文件规模，确认后再执行。
resources/common.md 中的通用规则resources/{语言}.md 中的语言特定规则（如存在）按通用规则和语言特定规则执行：
修改目标文件后，报告：
resources/common.md - 跨语言通用注释规则（判断标准、避免模式、标注约定）resources/{语言}.md - 各语言特有的注释语法和规范创建符合国人审美的网页界面设计。当用户需要设计网页、组件、页面或应用界面时使用。 专注于简洁、精致、和谐的设计风格，生成可直接使用的前端代码。 不用于审核已有 UI 代码、优化现有组件实现，也不用于生成纯后端代码或非 Web 端 UI。
用于撰写技术文章、技术教程、经验总结类长文。 当用户明确要写技术文章、技术博客、技术教程、踩坑记录、优化案例时触发。
创建或更新 AI 全栈 Web 项目的 PRD 产品需求文档。 用于用户明确要求生成 PRD、补充 PRD 内容、或更新现有 PRD 时触发。 不用于生成普通技术文档、API 文档或仅修改代码的场景。
管理项目的分层记忆系统，包括 work-log 更新、新记忆生成、容量检查和归档。 由用户手动执行本技能后触发记忆更新，不用于普通查询或非提交场景。
在目标项目中一键启用分层记忆管理系统，生成规则、技能和记忆库结构。 仅在用户明确要求为项目添加记忆功能时使用，不用于查询记忆、更新现有记忆或初始化普通配置文件。
创建基于当前技能 `scripts/` 参考工程的 Node.js + TypeScript 脚本项目骨架，或按同一结构补齐空白/轻量脚本项目。 当用户需要快速落地命令行脚本、批处理脚本或文件处理流水线时触发，不用于后端服务、前端项目、单文件脚本片段或成熟项目重构。