为QoderWake中Waker添加任务说明，需在新建任务时于基础设置填写不超过500字的自然语言描述；对已有Waker则通过CLI注入、Quest视图追加或记忆模块智能补全三种方式安全补全。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
给QoderWake中的Waker添加任务说明，是为了让数字员工在执行前明确目标边界、输入来源与输出规范，避免因语义模糊导致误操作或跳过关键校验环节。
在任务创建阶段直接填写说明
这是最常用也最推荐的方式，适用于新建任务时就需定义清晰意图的场景。
第一步：进入QoderWake控制台 → 【任务编排】→ 点击「新建任务」。
第二步：在「基础设置」区域找到「任务说明」文本框，输入不超过500字的自然语言描述。例如：“从GitHub拉取最近3天内所有merged PR标题与作者，按模块归类后生成Markdown摘要，排除draft状态PR。”
第三步：点击「保存草稿」或「提交审核」。此时说明已绑定至该Waker实例，后续所有执行日志、审计记录和AI响应都将引用此段文字作为上下文锚点。
【注意】任务说明一旦随任务发布生效，将自动注入Waker的长期记忆槽位，不可通过编辑界面直接删除——如需修改，必须克隆新任务并重新提交。
为已有Waker补全说明（非编辑模式）
当Waker已上线运行但缺少说明字段时，不能直接修改原始任务配置，需通过“版本快照+说明注入”方式安全补全。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
方法一：使用CLI命令注入
在终端中执行：qwctl waker describe waker_id_abc123 --inject-desc "每日02:00同步CRM客户等级字段至内部BI表，仅更新status=active的记录"。该命令会生成带说明的新版本快照，并自动切换Waker指向最新版。
方法二：通过Quest视图追加注释
进入Quest视图 → 找到对应Waker的运行记录 → 点击右侧「添加备注」图标 → 输入说明性文字 → 勾选「设为任务级说明」→ 提交。系统将把该备注提升为Waker元数据层的正式说明，覆盖此前空值状态。
利用QoderWake记忆模块自动补全说明
若Waker已关联项目知识库，可触发语义推导自动生成结构化说明，省去人工撰写成本。
打开Waker详情页 → 点击「智能补全」按钮 → 选择「基于代码变更推导说明」→ 系统扫描最近一次Git diff中涉及的函数名、SQL语句、API路径等信号 → 输出三行式说明草案：“作用：更新用户权限缓存；输入：Redis key pattern user:*:perm；输出：JSON格式布尔响应”。
确认无误后点击「采纳为正式说明」，Waker即刻加载该文本并写入元数据索引。
