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

homework

家庭作业排期、提交批改和复习提醒。用 CLI 批量读取 Trello 作业,口算、单词听写和英语阅读由服务端识别评分,并汇总易错题型、跟踪复习;支持普通作业、背单词、阅读英语和口算排期。依赖 trello skill,先读原文获取命令格式。

How do I install this agent skill?

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

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill manages homework scheduling and grading via Trello and the cyeam CLI. It includes features for automated reminders and processes external data from Trello, which introduces a surface for indirect prompt injection and persistence.

  • Socketpass

    No alerts

  • Snykwarn

    Risk: MEDIUM · 1 issue

What does this agent skill do?

家庭作业

用户提供作业内容清单和完成周期(起止日期),为周期内每一天 × 每项作业各创建一张 Trello 卡片。

作业总结与复习

用户要求批改、作业总结、查错题或复习提醒时,读取 references/review.md,执行批量拉取 → 服务端或模型判读 → 100/优/良/中/差评分 → 易错题归档 → 复习提醒。口算图片采用 arithmetic skill 的服务端识别、验算和评级;单词听写使用 cyeam dictation check --words <词表文件>;英语阅读使用 cyeam asr review 的服务端评分、练习链接和文案,回写使用 card review --reading-report。这些结果不让 AI 二次识别或复算;其它作业由当前模型识别、批改和评分。Trello CLI 负责获取材料及发布结果,不把下载成功或任务完成标记当成答对。用户要求提交批改结果时,必须将可判定的等级通过 cyeam trello card review --grade 100|优|良|中|差 一并写回;暂评加 --provisional,没有可判定内容时不评级。100 只用于整份明确全对,不用暂评;CLI 会自动标记批改通过。完整命令、重试规则和评分标准见上述参考文件。

批改默认不展示正确答案、完整解法或能反推出答案的差值;先在内部验算,再给判断与重做提示。仅在用户明确要求答案或允许指定场景先参考答案时,在该范围内展示。聊天、Trello 正文、媒体反馈和复习提醒均遵守;详细规则见上述参考文件。

英语阅读按参考文件中的专用评分规则:40%~60%(含两端)对应“中”,低于40%才为“差”;评分、实词统计、背单词模式链接和复读文案由 cyeam.com 服务端生成,不让模型自由编写,过滤 is/to 等功能词,不把缺失列为重点错误。

提取作业且需要录音文字时,在 cyeam trello homework 后加 --asr,直接读取音频附件的 transcript,不用逐个手动转写。

用户要求布置作业时,使用下方排期流程。

作业类型

  • 每项作业可带 type。省略时为普通作业;普通作业支持可选的作业链接。

  • 支持的类型为 普通作业、背单词、阅读英语、口算 和 预习。

  • 一项作业只对应一个具体任务和一张 Trello 卡片;不要为了单词或阅读链接额外创建卡片。

  • 普通作业有具体内容时使用 --type normal --task "<作业内容>";用户提供作业链接时,再加 --link "<原始网址>",不要改写或生成链接。用户以 Markdown 链接提供时,取括号中的目标网址传给 --link,不要传整段 Markdown。通用说明(预计时长、当日顺序等)仍放在 --desc。CLI 在同一张卡的描述中追加如下格式;未提供链接时省略“作业链接”一行:

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

    --link 仅支持普通作业,且必须同时提供非空的 --task。不传 --task、--link 时仍原样使用 --desc,兼容已有普通作业。

  • 背单词必须给出待背词表。创建作业前由布置作业的模型同时考虑词义、主题和拼写,把相关词排在一起。例如 bus stop, train station, airport 放在交通组,class, classmate, classroom 相邻。两种关系都明显时先按主题分组,再在组内让拼写相近的词相邻。保留完整词组和原词拼写,排序前后核对词表,确保每项都在。用户明确指定的词序优先。

  • 背单词通过 cyeam trello card create --type word_memorization 创建。每个已排序的单词或词组依次传一个 --word,卡片描述中的词表采用这个顺序,供平板原生背单词使用。旧版 CLI 使用 --task "<逗号分隔的词表>",用 bus(stop) 这样的写法保留多词词组,平板会识别为 bus stop。生成的描述示例如下。

    作业类型:背单词
    背单词:bedroom, armchair, cushions
    

    链接中的单词使用英文逗号分隔;不要将逗号替换为 %2C,以保持链接可读。

  • 阅读英语的具体任务必须由用户提供阅读链接,例如 /ai/translate?textbook=0&article=4。将该链接原样写进卡片描述;不要改写、补全、解析或生成链接。

  • 阅读英语必须通过 cyeam trello card create --type english_reading --task "<用户提供的链接>" 创建。 如果用户也给了课前跟读词表,按原顺序为每个单词或完整词组加一个 --word。平板先打开「读单词」,跟读后再进入课文。CLI 会在 desc 写入 作业类型:阅读英语 和 阅读英语链接:<链接>。

  • 口算:用户给出具体题目,或要求出题并布置到平板时,使用 --type arithmetic --task <多行题目>;需要出题时加载 arithmetic skill。每行一道题,不附答案、不排多栏,不生成 PDF。仅要求完成纸质练习册且没有具体题目时,仍按普通作业布置。

  • 口算每天一张卡片,--task 包含当天全部题目,不把 20 道题拆成 20 张卡片。CLI 自动写入 作业类型:口算 和 作业内容: 标识。

  • 预习使用 --type preview。CLI 写入 作业类型:预习,并在卡片描述末尾预留 预习要求:。用户已提供具体要求时用 --task <要求> 预填,否则省略。家长可在平板的「家长设置 → 预习要求」保存要求,平板提交预习成果时会把已保存的要求写入该字段。

重要:这是流程 Skill,不是 CLI 命令

  • 禁止执行 cyeam homework:这个命令不存在。不要将 Skill 名 homework 当成 CLI 子命令或可执行文件。
  • 本 Skill 负责排期、模型批改、错题归档和复习工作流;所有实际查询和创建都必须加载并遵循 trello Skill,且命令必须以 cyeam trello 开头。
  • cyeam trello homework --board <board-id> 是查看当天已有作业和下载附件的只读报告命令,不能用于新增作业。新增作业只能使用 cyeam trello card create。

前置

  • Trello 操作全部走 trello skill(.agents/skills/trello/SKILL.md),命令格式以它为准,禁止瞎猜。
  • 未登录先 cyeam trello login,用 cyeam trello status 确认凭据有效。
  • 不知道看板/列表 ID 时:先 cyeam trello boards 找到学习任务看板,再 cyeam trello lists <board-id> 找到「待执行」列表。不要按名称猜 ID。

流程

  1. 解析用户输入:作业项目列表(如口算、练字、钢琴、背单词或阅读英语)、每项的可选类型、具体任务和作业链接、起止日期(含首尾)、可选的起始天数序号,以及每日可做作业的开始/结束时间、作业时长或难易程度。未给类型按普通作业处理;具体口算题目按上述口算规则处理。未给结束时间时,默认当天在 20:00 前完成。

  2. 先为每一天生成同一份有序作业列表,再据此安排截止时间:

    • 先按学科/大类分组。保留用户明确给出的学科顺序;未给出时按常见学习顺序排列:语文、数学、英语、其他学科、兴趣/运动。无法判断类别的项目保持用户清单中的相对顺序并放在最后。
    • 每个大类内先易后难、先写好写的。以用户标注的难易为准;否则依据任务性质判断:短时抄写、朗读、简单口算等在前,长篇写作、大量题目、订正、需要准备材料或他人配合的项目在后。仍无法判断时保留用户输入顺序,不虚构难度。
    • 为每项估算实际完成时长,依次优先采用:用户明确的时长;依据题量、字数、页数和用户提供节奏的推算;该项目相近日期的合理用时;保守的任务类型估计。估时精确到 5 分钟,并必须写入计划;信息不足时标记“估算”,不得给所有项目套用同一个固定时长。
    • 以每天的结束时间为锚点,按排好序的列表倒推各卡片的截止时间:最后一项截止于结束时间,前一项截止于其后任务的开始时间;每项占用其预计时长,且相邻任务预留 5 分钟缓冲。用户会看到从先做的简单任务到后做的困难任务、逐步递增且各不相同的截止时间。用户为某项指定截止时间时,以其指定为准,并重新安排未固定的相邻项目。若指定的开始和结束时间装不下总时长,保留顺序、如实报告超出的分钟数,并在创建前请用户调整时段或内容。
  3. 展开成创建计划,周期内每一天、每项作业一张卡片:

    • 标题:<作业名>(第N天),N 逐天递增。用户给了起始序号就用它;没给则先 cyeam trello cards --board <board-id> 看已有卡片的编号规律,从最大序号 +1 继续;完全没有规律可遵循时用 <作业名>(YYYY-MM-DD)。
    • --due:上一步倒推出的当天、本机时区 RFC3339 截止时间(如 2026-09-08T19:25:00+08:00)。
    • 用户明确提出作业要求时(如“写清题号,做完检查一遍”),给对应卡片传 --requirements "<原要求>"。CLI 写成独立的「作业要求:…」字段,平板打开卡片时会高亮并朗读。
    • 普通作业有具体内容(如“完成第一课练习”)时写进 --task,用户提供的作业网址写进 --link;所有卡片的 --desc 同时写入预计时长和在当日列表中的顺序,例如“预计 15 分钟;当日第 2 项”。
    • 背单词的预计时长和当日顺序写入 --desc。把排序后的词表放进确认清单,再按同一顺序传入 --word。CLI 会在同一张卡片写入词表,平板据 作业类型:背单词 进入单词交互。
    • 口算:将预计时长按独立行 预计用时: 5 写入 --desc,当日顺序等说明也放在 --desc;当天所有题目以真实换行传给 --type arithmetic --task,题目之后不追加说明或答案。
    • 阅读英语:把预计时长、当日顺序等通用说明写入 --desc,并把用户提供的链接原样传给 --type english_reading --task。CLI 会在同一个 desc 后追加类型和链接;平板据 作业类型:阅读英语 进入阅读交互。
    • 预习使用 --type preview,把预计时长和当日顺序等通用说明写入 --desc。仅在用户已提供预习要求时传 --task。
  4. 去重:cyeam trello cards --list <list-id> 检查,同名且同 due 的卡片已存在则跳过。

  5. 把完整计划清单按每天的执行顺序列给用户确认一次。每行至少含:日期、学科/大类、类型、序号、作业、难易依据、预计时长、开始—截止时间、标题;确认后按类型逐条创建:

    # 普通作业:未提供链接时省略 --link
    cyeam trello card create --list <list-id> --name "<作业名>(第N天)" --due <RFC3339> \
      --type normal --task "完成第一课练习" --link "https://实际的作业网址" --desc "<通用说明>"
    
    # 背单词:用 --word 依次传入单词或词组
    cyeam trello card create --list <list-id> --name "<作业名>(第N天)" --due <RFC3339> \
      --type word_memorization --word "bus stop" --word "train station" --word "airport" --desc "<通用说明>"
    
    # 口算:--task 使用真实换行,每行一道题
    cyeam trello card create --list <list-id> --name "口算20题(第N天)" --due <RFC3339> \
      --type arithmetic --task '26 + 17 = ___
    

54 − 28 = ___' --desc '预计用时: 5'

阅读英语:--task 为用户提供的原始链接

cyeam trello card create --list <list-id> --name "<作业名>(第N天)" --due <RFC3339>
--type english_reading --task "/ai/translate?textbook=0&article=4" --desc "<通用说明>"


6. 汇报结果:创建成功 / 跳过(已存在)/ 失败各多少张,失败的附原因。

## 规则

- 每天每项作业一张卡片,不要把多天或多项作业合并成一张。
- 背单词、阅读英语和口算必须使用对应的 `--type` 及内容参数,使 CLI 写入机器可读的描述。作业类型和对应内容保存在同一张卡片。
- 截止时间是执行计划的一部分:不得再将当天所有卡片设为同一固定时间,也不得在未估算时长或排序的情况下创建卡片。
- 批量创建是对外部状态的批量变更,必须先列出计划清单获得用户一次确认再执行。
- 周期跨月/跨年时逐日展开,不要漏掉首尾日期。
- 日期、due 一律用本机时区。

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/homework">View homework on skillZs</a>