Qoder支持通过代码注释与Trello联动实现任务自动创建和状态同步：一、启用OAuth 2.0 API集成；二、用// @trello注释声明任务；三、用// @trello-update更新卡片状态；四、通过Git提交信息闭环进度；五、自定义注释解析规则。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 Qoder 进行代码开发时，希望将任务管理无缝嵌入编码流程，避免在 IDE 与 Trello 之间频繁切换，则可通过代码注释触发看板任务的自动创建与状态同步。以下是实现该联动的具体操作步骤：
一、启用 Qoder 与 Trello 的 API 集成
该步骤建立 Qoder 对 Trello 资源的合法访问权限，是后续所有注释驱动操作的前提。Qoder 需通过 OAuth 2.0 协议获取用户授权，并持有有效令牌以调用 Trello 的看板、列表与卡片相关接口。
1、在 Qoder 桌面应用中，进入 设置(Settings) → 集成(Integrations) → 添加第三方服务。
2、从服务列表中选择 Trello，点击“连接”按钮。
3、系统跳转至 Trello 授权页面，使用与目标看板关联的账户登录，并勾选 “读取和写入您的看板、卡片与成员信息” 权限。
4、确认授权后，Qoder 将保存访问令牌，并显示 “Trello 已连接，可识别工作区与看板” 提示。
二、在代码注释中声明任务意图
Qoder 通过预设的注释语法识别开发者意图，自动解析任务名称、所属看板、截止日期及优先级等元信息。该机制不依赖外部配置文件，全部内嵌于源码注释中，确保上下文一致性与可追溯性。
1、在任意支持的代码文件（如 .py、.ts、.java）中，插入以 // @trello 开头的单行注释。
2、在该注释后按顺序填写字段，格式为：// @trello [看板名] [列表名] [任务标题] [截止日期:YYYY-MM-DD] [标签]。
3、例如，在 backend/src/user/service.ts 文件中添加：// @trello 客户网站改版项目 进行中 用户登录态校验 2026-06-15 auth,high。
4、保存文件后，Qoder 后台服务将在 10 秒内扫描并触发任务创建流程，无需手动执行命令。
三、通过特殊注释更新已有卡片状态
当任务已存在且需推进至下一阶段（如从“进行中”移至“测试验证”），可在对应代码块上方添加状态更新指令。Qoder 将根据卡片标题与当前看板匹配唯一卡片，并执行列表迁移操作，同时记录变更时间戳。
1、定位到与任务强相关的函数或模块顶部，插入新注释行：// @trello-update [看板名] [原列表名] → [目标列表名] [卡片标题]。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
2、确保 [卡片标题] 与原始创建注释中完全一致，包括大小写与空格。
3、例如：// @trello-update 客户网站改版项目 进行中 → 测试验证 用户登录态校验。
4、Qoder 执行迁移后，会在卡片描述末尾追加一条日志：[Qoder] 状态由「进行中」更新为「测试验证」｜2026-05-23 03:12。
四、基于 Git 提交信息自动同步任务进度
该方法绕过注释语法，利用代码提交行为反向驱动看板更新。Qoder 监听本地仓库的 git push 事件，提取提交信息中的关键词，匹配 Trello 卡片 ID 或标题，完成状态闭环。
1、在提交消息中包含 “Closes #CARD-ID” 或 “Resolves [卡片标题片段]” 格式内容。
2、确保提交推送到已绑定的远程仓库（如 GitHub/GitLab），且该仓库与 Qoder 中配置的项目上下文一致。
3、Qoder 在检测到推送后，发起对 Trello API 的 GET /cards/{idOrShortLink} 请求，验证卡片存在性。
4、若匹配成功，自动将卡片移入 “已完成”列表，并在卡片评论区添加链接至本次提交的 commit hash。
五、配置注释解析规则与字段映射
开发者可自定义注释语义规则，使 Qoder 支持非标准字段（如自定义优先级标识、负责人分配）或适配团队内部命名习惯。该配置以 JSON 形式存储于项目根目录的 .qoder/trello-config.json 中，仅对当前 Workspace 生效。
1、在项目根目录创建 .qoder 文件夹，并新建 trello-config.json。
2、填入字段映射定义，例如：{"assignee": "@dev", "priority": "P{number}", "estimate": "EST:{hours}h"}。
3、在代码注释中即可使用：// @trello 个人事务 待办事项 数据导出脚本 2026-05-30 @dev P1 EST:2h。
4、Qoder 解析时将自动提取 @dev 并尝试添加为卡片成员，将 P1 映射为标签，EST:2h 写入卡片描述。
