SuperAPI AI 工具集

ielts-progress-reporter

写作与研究

查看项目

更新于 10-16 06:21

技能介绍

用途:把雅思写作练习库中已积累的反馈文件汇总成进度报告,回答“是否在进步、哪些错误反复出现、下一步该练什么”。反馈文件是唯一数据来源,技能只读取和聚合已有内容,不重新批改作文,也不为没有反馈文件的练习编造分数。

主要能力:解析 feedback/ 下每个 .md 文件的 YAML frontmatter,读取 task、prompt_id、version、date、band_overall、band_cc、band_lr、band_gra 以及 band_ta(Task 1)或 band_tr(Task 2)和 errors 标签列表;将 TA/TR 统一为“第一评分项”趋势线,使 Task 1 与 Task 2 可并列比较;输出覆盖次数、各评分项平均分、错误频率、多版本 prompt 的修订分数变化,周期模式下按周/月分桶。

使用方式:先定位 vault 根目录下的 feedback/ 目录;选择累计(cumulative)或周期(period)范围,可按 task 或日期范围收窄;运行自带脚本聚合,例如 python3 scripts/aggregate_feedback.py --vault <VAULT_ROOT> --mode cumulative,或 python3 scripts/aggregate_feedback.py --vault <VAULT_ROOT> --mode period --period monthly,可用 --feedback-dir、--task、--since、--until 等参数,脚本无第三方依赖;再按 references/spaced-error-reprobes.md 维护 _dashboard/ielts-reprobe-ledger.yaml,若有过期重测项则只纳入最早到期的一个;最后按模板生成报告,写入 _dashboard/ 的带日期文件,如 progress-2026-06-24.md 或 progress-2026-06.md,不覆盖已有同名文件,也不改动 Dataview 驱动的 writing-progress.md。

适用场景:用户想查看多次练习的整体趋势、询问哪些错误最常出现、需要周报/月报或累计快照,或指向 feedback/、_dashboard/ 要求汇总时。

限制:没有反馈文件时无法聚合,应直接说明,不得从原始作文估算分数;单篇批改应交给 ielts-writing-task1 或 ielts-writing-task2,学习计划交给 ielts-learning-planner;样本仅两三次时应说明趋势尚不具意义;显示分数按雅思方式取半档描述,不虚构考生不可能获得的半档;Task 1 的分数按记录报告,不在此重新讨论数据准确性。