AionClaw支持注释驱动的代码补全，需在【开发顾问】角色下使用「基于注释生成实现」能力，输入含参数与返回值说明的标准文档注释后，通过指令或快捷技能触发生成，结果含校验、逻辑、异常三段式结构并支持沙箱测试。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让AionClaw根据已有代码注释自动补全函数体、方法逻辑或完整模块，而不是手动逐行敲写重复结构。
确认AionClaw是否支持注释驱动的代码补全
打开AionClaw客户端，进入【数字专家】→【开发顾问】面板，点击右上角「能力清单」图标。在「代码生成」分类下查找「基于注释生成实现」条目——该能力默认启用，无需额外安装插件。
注意：此功能仅在调用「开发顾问」角色时生效，普通对话模式下不会触发代码补全逻辑。
准备待补全的带注释代码片段
将含标准文档注释（如Python的Google风格、Java的Javadoc、Go的//+）的代码块复制进输入框。例如：
# @param name: 用户姓名，非空字符串\n# @param age: 年龄，整数且大于0\n# @return: 格式化后的欢迎语句
注释必须明确包含参数说明与返回值定义，否则AionClaw无法准确推断函数签名。缺少@type或类型关键词会导致生成逻辑模糊。
触发注释转代码操作
方法一：在输入框中输入指令
直接发送：“请根据以上注释，生成完整的Python函数实现。”
方法二：使用快捷技能
点击输入框右侧「⚡」按钮→选择「注释补全代码」→确认执行。
【必须粘贴原始注释文本，不能只说“按上面的注释写”】 AionClaw不支持跨消息上下文回溯注释内容，上一条消息若未包含可解析的注释结构，本次请求将返回通用模板而非精准实现。
获取并验证生成结果
第一步：等待AionClaw返回带缩进的完整函数体，通常含参数校验、主逻辑、异常处理三段式结构。
第二步：检查生成代码是否包含你注释中声明的全部参数名和返回值类型提示。若缺失，说明注释格式不规范，需补全@type或改用更明确的描述方式。
第三步：点击结果块右下角「▶️ 运行测试」按钮，AionClaw会自动启动沙箱环境执行单元测试，验证边界条件是否覆盖。
