任务说明必须用中文填写且不可为空，需包含谁发起、做什么、为什么做三要素；按ai定时任务、定时触发策略、webhook事件驱动三类分别明确数据源、执行动作与输出路径、外部系统及事件语义；保存前经四步校验通过方可生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想让QoderWake执行自动化任务时能被团队成员一眼看懂用途、触发条件和关键参数，而不是只看到一串模糊的“task_20260730_v3”或“auto-run-1”，这就必须在创建任务时准确填写任务说明——它不是可选字段，而是任务审计、协作排查与权限审批的核心依据。
任务说明填写位置与基础规则
进入【自动化】→【AI定时任务】或【触发管理】→【定时触发】模块后，新建任务表单中，“任务名称”下方紧邻的文本框即为“任务说明”字段。该字段最大支持512字符，【必须用中文填写，不可留空或仅填英文缩写】。若此处为空，系统将拒绝保存并提示“请补充任务说明”，且无法跳过。
说明内容需包含三个要素：谁发起、做什么、为什么做。例如：“研发组每日8:00自动抓取GitHub PR列表，用于晨会快速同步代码评审进度”。不能写成“每日PR同步”或“fetch pr”。
不同任务类型下的说明撰写要点
任务说明不是自由发挥的备注栏，它要匹配任务类型的实际运行逻辑，否则会导致协作误判或审计驳回。
Qoder Linux版是由阿里推出的智能体自主开发工作台，支持开发者通过定义需求即可让Agent团队“自动驾驶”，自主完成代码执行、验证与交付的全流程。其全新的Quest独立视窗集成了任务管理与状态追踪能力，并支持跨项目多任务并行处理，显著提升开发效率。此外，Qoder还提供专家团模式与团队级知识引擎，适配复杂开发场景。
方法一：AI定时任务（/report weekly类）
说明必须体现AI行为边界与数据来源。例如：“调用/report weekly指令，提取用户近7日GitHub提交+钉钉审批记录，生成含代码行数/审批通过率的PDF周报，发送至weekly@team.qoder”。【若未注明数据源，审核员将退回要求补全】
方法二：定时触发策略（Cron驱动脚本）
说明必须绑定具体执行动作与输出路径。例如：“每天01:30在沙盒中执行db.export_table，导出users/orders表为Parquet格式，存至/backups/daily_{{now|strftime:%Y%m%d}}.parquet”。避免使用“备份数据库”这种模糊表述。
方法三：Webhook事件驱动任务
说明必须明确外部系统身份与事件语义。例如：“接收来自飞书多维表格‘上线申请’工作表的新增行事件，自动创建Jira EPIC并关联对应Git分支”。不能只写“响应飞书事件”。
填写后如何验证是否合格
第一步：点击“保存并激活”前，系统会实时校验说明文本。
第二步：若说明中出现“自动”“定时”“每X小时”等词但未配套Cron表达式或触发源，则弹出黄色警告：“检测到时间描述词，但未配置对应触发机制，请确认是否遗漏”
第三步：若说明含敏感操作关键词（如“删除”“覆盖”“清空”），系统强制要求勾选“已确认高危操作”复选框，否则无法提交。
第四步：保存成功后，在任务详情页顶部“说明”区域右侧，会出现一个绿色对勾图标，鼠标悬停显示“已通过语义完整性校验”，表示说明符合平台协作规范。
