skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
mnhkahn/cyeam-cli89 installs

trello

Trello 学习任务看板——通过 cyeam CLI 查询看板、状态分组和当天任务;创建、修改、移动任务;上传和查看成果照片;查看任务历史;注册或删除实时 Webhook。用户提到 Trello、学习任务看板、待执行/已提交/已验收状态、任务照片或 Trello 同步时使用。必须先读 skill 原文获取正确命令格式,禁止瞎猜。

How do I install this agent skill?

npx skills add https://github.com/mnhkahn/cyeam-cli --skill trello
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill manages Trello learning tasks and attachments using the cyeam CLI tool. It follows secure practices for credential management by utilizing the system keychain or restricted local files. However, it presents a low-level risk for indirect prompt injection due to its processing of untrusted content from external Trello boards and audio transcriptions.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

Trello 任务看板

使用 cyeam trello,不要自行拼装 Trello HTTP 请求。首次使用先运行 cyeam trello login --key <api-key>,在浏览器授权后把页面显示的 Token 粘贴回 CLI;CLI 验证并存入系统钥匙串,钥匙串不可用时回退到权限为 0600 的 ~/.cyeam/trello.json。绝不输出凭据。

规则

  • 不知道 ID 时,先 boards,再 lists <board-id>;不要按名称猜测 ID。
  • 查询当天任务使用 cards --board <board-id> --today;按本机时区和 due 筛选。
  • 创建、修改、移动、上传附件及 Webhook 增删会改变外部状态,必须先获得用户明确确认。
  • Webhook 命令只管理订阅;公网 HTTPS 接收端、验签、去重和安卓同步由独立服务实现。
  • 环境变量 TRELLO_API_KEY 和 TRELLO_TOKEN 仅用于 CI 或临时覆盖;设置其中一个时必须同时设置另一个。

命令

cyeam trello login --key <api-key>
cyeam trello status
cyeam trello logout

cyeam trello boards
cyeam trello lists <board-id>
cyeam trello cards --list <list-id> [--today]
cyeam trello cards --board <board-id> [--today]
cyeam trello status-changes --board <board-id>
    [--date <YYYY-MM-DD>] [--to-list <list-id>] [--limit 1000]
cyeam trello homework --board <board-id>
    [--date <YYYY-MM-DD> | --from <YYYY-MM-DD> --to <YYYY-MM-DD>]
    [--include-actions] [--audio-only] [--asr] [--dir <目录>]
    [--max-width 1200] [--max-bytes <bytes>]

cyeam trello card create --list <list-id> --name <title>
    [--desc <text>] [--due <RFC3339>] [--labels <label-id,...>]
    [--requirements <text>]
    [--type normal|word_memorization|english_reading|arithmetic|preview] [--task <text>]
    [--link <url>] [--word <word-or-phrase> ...]
cyeam trello card update <card-id>
    [--name <title>] [--desc <text>] [--due <RFC3339>] [--complete=true|false]
cyeam trello card move <card-id> --list <target-list-id>
cyeam trello card attach <card-id> --file <local-path> [--name <display-name>]
cyeam trello card attachments <card-id>
cyeam trello card attachment get <card-id> <attachment-id>
    [--out <local-path>] [--max-width <px>] [--max-bytes <bytes>]
cyeam trello card actions <card-id> [--limit 50]

cyeam trello webhook create --callback-url <https-url> --model-id <id>
    [--description <text>]
cyeam trello webhook delete <webhook-id>

card update --due "" 清除截止时间;未传 --complete 时不改变任务完成标记。默认输出是 JSON 信封,--pretty 输出响应 JSON。

创建家庭作业卡片时,--type 默认 normal,与原先直接传 --desc 的行为一致。--type word_memorization --task "bedroom, armchair" 只将作业类型和词表写入描述;--type english_reading --task "/ai/translate?textbook=0&article=4" 会将用户提供的链接原样写入描述。每个任务只创建一张卡片。

给背单词作业传入已排好的词序时,每项重复一个 --word,例如 --type word_memorization --word "bus stop" --word "train station" --word "airport"。词表保留这个顺序,每个词组作为一项。--word 与 --task 二选一。由 homework 流程在创建作业前按词义、主题和拼写整理词表。

用户给出需要平板高亮并朗读的作业要求时,使用 --requirements "写清题号,做完检查一遍。"。CLI 在卡片描述中写入独立的「作业要求:…」字段,适用于所有作业类型。

背单词 --task 仅按英文或中文逗号分项,空格属于词组,例如 --task "ice cream, piece of cake" 是两项。--word 与 --task 都按 Android 原生背单词的规则校验:支持英文字母、词内撇号('、’)、连字符 - 和词组空格;英文括号续词如 post(office) 转成 post office,中文括号注释如 camera(相机) 去掉。数字、网址、其它标点和不完整括号会在创建前报错;阅读英语的 --word 也执行同一校验。两端空白及词组内连续空白会规范化,词序与大小写保留。

阅读英语可以同时传课文链接和跟读词表,例如 --type english_reading --task "<原始课文链接>" --word "robotics" --word "build our own"。CLI 会按原顺序写入「读单词:…」字段。

普通作业支持 --type normal --task "完成第一课练习" --link "https://实际的作业网址"(类型也接受 普通作业)。--task 为作业内容,--link 为用户提供的原始目标网址;若输入为 Markdown 链接,提取括号中的网址,不传整段 Markdown。通用说明放在 --desc。CLI 保留说明并追加:

类型: 普通作业
作业内容: 完成第一课练习
作业链接: [https://实际的作业网址](https://实际的作业网址)

没有链接时省略 --link,描述中也省略“作业链接”一行。--link 仅用于普通作业,必须同时提供非空 --task,链接不允许包含换行。不传 --task、--link 的普通作业仍原样使用 --desc。更新已有普通作业时,使用 card update --desc 提交完整描述;更新命令没有 --type、--task 或 --link 参数。

口算使用 --type arithmetic --task <多行题目>(类型也接受 口算)。--task 每行一道题,使用真实换行;不放题单标题、姓名栏、答案、Markdown 表格或多栏排版。预计用时等说明放在 --desc,例如 预计用时: 5。CLI 保留说明并追加 作业类型:口算、作业内容: 和完整题目;平板读取题目并自动排版。

cyeam trello card create --list <list-id> --name "口算20题(第N天)" --due <RFC3339> \
  --type arithmetic --task '26 + 17 = ___
54 − 28 = ___' --desc '预计用时: 5'

更新已有口算卡片时,card update 仍使用 --desc 提交完整描述(包括类型、预计用时、作业内容: 和全部题目);该命令没有 --type 或 --task 参数。通用说明写在 作业内容: 之前,后面只放题目。

预习使用 --type preview,也接受 --type 预习。CLI 在通用描述末尾追加 作业类型:预习 和 预习要求:。创建卡片时可省略 --task,也可用 --task <要求> 预填多行要求。家长可在平板的「家长设置 → 预习要求」保存要求,平板提交预习成果时会把已保存的要求写入该字段。

获取图片时先用 card attachments <card-id> 找到 attachment-id、文件名和 MIME 类型,再调用 card attachment get。需要在飞书展示时优先传 --out <local-path>:CLI 会使用已保存的 Trello 凭据下载受保护附件,并把图片字节直接写入文件,返回 saved_to、name、mime_type 和 size_bytes;Agent 随后上传该本地文件。默认下载原图,图太大时加 --max-width <px> 下载服务端预览图(WebP,体积小得多,内容为 WebP 时 mime_type 为 image/webp)。不要自行解析 JSON、解码 Base64,也不要把受保护 URL 直接发给飞书。仅在调用方明确需要内联数据时省略 --out,此时响应才包含 base64。附件默认上限为 25 MiB。

status-changes 按本机时区查询某一天的卡片列表流转记录,默认查询今天,返回卡片、流转前后列表、操作者和 changed_at。整理每日完成任务时,必须先用 lists <board-id> 找到完成列表 ID,再传 --to-list <list-id>;不要按列表名称猜测。

查某一天的作业进度和提交附件,使用完整命令 cyeam trello homework --board <board-id>:筛出 due 当天的卡片,返回每张卡片所在列表并下载全部附件到本地目录(默认 homework-<date>/)。这是只读报告命令,不创建或追加作业;不要写成不存在的 cyeam homework,新增作业请使用 cyeam trello card create。默认下载不超过 --max-width(1200)宽的最大图片预览;传 --max-width 0 下载原始文件。JSON 报告里每个附件带 saved_to 路径和 homework_photo_url 链接(形如 https://trello.com/1/cards/<card-id>/attachments/<attachment-id>/download/<filename>,浏览器登录 Trello 后可直接打开);加 --pretty 输出人可读的文本报告。内置超时重试,单卡片失败不中断。

录音附件使用文件名前缀 homework-audio- 标记,命名格式为 homework-audio-{提交ID}-{序号}.{扩展名}。trello homework 会像其他附件一样列出并下载录音;只提取录音时加 --audio-only,例如 cyeam trello homework --board <board-id> --from <YYYY-MM-DD> --to <YYYY-MM-DD> --audio-only。录音保存在报告目录下对应卡片的子目录,路径见附件的 saved_to 字段;下载需要有效的 Trello CLI 授权。提取时加 --asr 可将所有作业类型的音频附件经 ASR 转写,直接在每个附件的 transcript 字段返回文字,--pretty 同时展示“识别文本”;失败写入 transcript_error,保留本地音频且不中断其它附件。音频按录音前缀、MIME 或扩展名识别。--asr=false 关闭全部转写。未显式传 --asr 时,保留英语卡片(标题含「英语」或类型为阅读英语/背单词)自动转写的旧行为,可用 --transcript=false 关闭;显式 --asr 优先于旧参数。报告里没有 transcript 的旧录音或例外情况,可用 asr skill 的 cyeam asr <saved_to 路径> 手动转写,不要自行拼装识别请求。

提取图片的硬性规则:查看或转发图片一律用 saved_to 本地文件,用读图工具打开确认内容后再展示;homework_photo_url 链接仅作展示,禁止对它 curl/wget 或发给飞书(无浏览器会话会 401/403)。逐个附件检查报告:error 非空或 size_bytes 为 0 表示下载失败,用 card attachment get <card-id> <attachment-id> --out <path> 单独补下(默认下载原图,加 --max-width 1200 下载小体积预览图)。

作业总结可用 cyeam trello homework --board <board-id> --from <YYYY-MM-DD> --to <YYYY-MM-DD> --include-actions 一次批量读取多天材料。起止日期含首尾,与 --date 互斥;省略日期仍查今天。按截止日期筛选当前未归档卡片,不是按提交时间筛选;无截止日期及归档卡片不在报告内。报告增加 from、to 和每张卡的 desc 原题描述;--include-actions 额外返回每卡最近最多 1000 条 actions(含评论),读取失败写入 actions_error,不阻断图片下载。历史达到 1000 条时应声明可能截断。附件目录包含卡片 ID,避免同名作业混淆。模型批改和复习记录流程见 homework skill;CLI 不自行评分。

打分结果字段

发布批改时,传 --grade 100|优|良|中|差 同时将卡片描述的第一行写为「打分结果:良」并写入本次批改评论。只替换第一行已有的同名字段,否则在原描述前新增一行,保留原题和其他说明。此方案兼容 Trello 免费版,不依赖原生自定义字段。100 只表示整份明确全对,自动按批改通过处理,不与 --provisional 或 --has-errors=true 并用。有待判定内容的暂评另加 --provisional,显示如「打分结果:暂评·良」。没有可判定内容时不传评分,不能从完成状态推断。

旧版本可能没有这些参数,先看 cyeam trello card review --help;不支持时提示升级,不覆盖用户已安装的 CLI,也不声称评分已同步。100 以外的评分与 --has-errors 独立:高等级也可能有错,暂评不能据等级判整份通过。

重试必须保持相同 UUID、评分、暂评标志、正文和结果参数;评论已发布而描述更新失败时只补更新,不重复评论。成功后重跑同一 UUID 不重放旧评分;新一轮批改用新 UUID 保留历史。发布期间不要并行编辑同一卡片描述。

发布作业批改(协议 v1)

批改反馈默认只给题号、判断、评分、错因类型和重做提示;正确答案、完整解法及能反推出答案的差值仅供内部核验,不写入 --text、--text-file 或图片/音频附件。只有用户明确要求答案或允许指定场景先参考答案时,才在该范围内提供;要求检查、判分或订正不等于允许展示答案。完整规则见 homework skill 的 references/review.md。

cyeam trello card review <card-id> --text <纯文本> [--review-id <UUID>] [--grade 100|优|良|中|差] [--provisional]
cyeam trello card review <card-id> --text-file <UTF-8文件> [--review-id <UUID>]
cyeam trello card review <card-id> --reading-report <asr-review生成的JSON> [--review-id <UUID>]
cyeam trello card review <card-id> --image <本地图片> [--review-id <UUID>]
cyeam trello card review <card-id> --audio <本地音频> [--review-id <UUID>]

这些内容参数必须且只能选一个。--reading-report 用于英语阅读:提取 cyeam asr review 报告中的 input,调用服务端 /api/homework/reading/regrade 重新生成固定文案和等级;不要同时传 --grade 或 --provisional,也不再支持 --confirmed-grade。中间 JSON 里被改写的反馈和得分字段不会影响回写结果。始终写原卡片,不创建卡;有评分时仅在描述顶部写入“打分结果”,保留原题和其他说明。可选 --has-errors=true|false 明确发布是否有错:true 转入「待改错」并清除 dueComplete;false 批改通过,当前为「已改错」时保留该状态,否则进入「已完成」,dueComplete=true。省略时只发布批改内容,不移动列表或修改完成标记;--grade 100 是例外,自动按 --has-errors=false 处理。目标列表按卡片看板查询 ID,缺少时自动创建。每次发布一条以 作业批改: 开头的 JSON 评论;图片/音频先上传为原生文件附件,再以附件 ID 发布评论。图片扩展名支持 jpg/jpeg/png/webp/gif;音频支持 m4a/mp3/wav/aac/ogg/opus/amr/3gp。文件必须非空,最大 50 MiB;扩展名应与真实文件格式一致,音频优先 M4A/AAC 或 MP3。

默认生成 UUID,执行时在 stderr 输出 review_id 和 state_file;也可首次提交就显式指定 UUID。成功响应包含 review_id、card_id、action_id、state_file,媒体还包含 attachment_id。状态保存在 ~/.cyeam/trello-reviews/<UUID>.json(0600),包括正文、附件 ID、action ID,不包含 Token。不要删除仍可能重试的状态文件。

失败后用同一 UUID、同一卡片、完全相同内容重跑命令。CLI 先查同名原生附件及卡片评论(分页),恢复已成功的上传/发布;已成功的本地记录直接返回,不重复发评论。同一 UUID 改内容或是否有错(包括省略该参数)会报错。评论成功但状态更新失败时,使用完全相同参数和 UUID 重试,只补状态,不重发评论;整个流程成功后重跑不重放状态。评论恢复排除发布前已存在的同文评论,因此新 UUID 可发布相同文案作为新一轮历史。

如果请求结果未知且查询仍未发现匹配记录,CLI 默认停止,不盲目重复 POST。稍后继续用同一 UUID 重试核对;仅在人工确认之前的写入失败后,才可加 --retry-uncertain 允许再次 POST(仍有重复风险)。此选项必须显式传原 --review-id。如果进程崩溃留下 .lock,先确认该提交没有进程仍在运行,再移除对应锁文件;保留 JSON 状态。

新一轮批改使用新 UUID 保留历史;不要删除旧评论引用的附件。命令不提供设备 Token、不上传外链、不修改原评论。完整用法与验收边界见仓库 docs/trello-review.md。

作业统一使用四个列表状态:待完成 → 已完成 → 待改错 → 已改错。已改错表示孩子提交了订正,尚不代表复批通过;复批仍错回待改错,通过保留已改错。homework 报告新增 status:todo/completed/needs_correction/corrected,非上述列表为 unknown;list_name 保留原名,不从 due_complete 猜测正确率。发布前依据最新一轮提交判读;有待判定内容且无法确认整份作业通过时,省略 --has-errors。

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/mnhkahn/cyeam-cli/trello">View trello on skillZs</a>