Skip to content

Jobo16/ielts-buddy / skills/ielts-study-plan

ielts-study-plan

Verified

根据考试目标、可用时间与真实学习证据制定或调整雅思学习安排,进行每日接续、周复盘,或将用户要求的下一步保存为 IELTS Buddy 待办。

references/learning-resource-recommender/WORKFLOW.md

View on GitHub
# Learning Resource Recommender

> 当当前学习任务需要本方法时按需读取。脚本命令中的 `scripts/` 相对于本 Skill 根目录;执行时解析为安装目录中的绝对路径。

## Core Rule

Recommend resources as a learning decision, not a link dump. Use IELTS Buddy state and the learner's current weakness first, then choose a small number of external resources that fit the skill, level, time budget, and learning mode.

The learning-resource catalog is bundled in this Skill and maintained by the repository developer. Do not depend on external local paths or ask the learner to provide the catalog.

## Inputs

Use any available combination:

- IELTS Buddy route progress, weak skills, vocabulary progress, or recent practice errors.
- User goal: IELTS band, CEFR level, target skill, accent preference, topic interest, available minutes.
- The curated catalog at `references/resources.json`.
- Direct resource candidates supplied in chat.

## Workflow

1. Identify the learner's current need:
   - listening input;
   - pronunciation/speaking;
   - reading input;
   - writing support;
   - vocabulary;
   - grammar;
   - exam-specific IELTS practice;
   - background immersion.
2. Run `scripts/learning-resource-recommender/extract_learning_resource_catalog.py` to read the bundled catalog. Prefer entries reviewed recently enough for the current request; verify unstable availability before making a high-cost recommendation.
3. Filter candidates by:
   - target skill;
   - level or difficulty cues;
   - IELTS relevance;
   - availability of transcripts/subtitles/exercises;
   - cognitive load and time budget;
   - whether the learner needs input, output, or review.
4. Recommend 3-7 resources only.
5. For each resource, explain:
   - why this resource fits the current need;
   - how to use it this week;
   - what output or review artifact to bring back to the Agent.
6. Prefer official, stable, learner-friendly resources when choices are close.
7. If a resource is entertainment-first, label it as immersion, not IELTS practice.

## Default Output

Use concise chat for quick recommendations. When the user asks for a study pack, weekly resource plan, or printable recommendation list, deliver a validated `.docx`.

1. Build a recommendation plan.
2. Generate the DOCX with `scripts/learning-resource-recommender/create_resource_recommendations_docx.py`.
3. Validate it with `scripts/learning-resource-recommender/validate_resource_recommendations_docx.py`.
4. Return the absolute path to the final DOCX.

## Bundled Resources

- `scripts/learning-resource-recommender/extract_learning_resource_catalog.py`: parse a Markdown resource catalog into JSON candidates with title, URL, description, and heading path.
- `scripts/learning-resource-recommender/create_resource_recommendations_docx.py`: create a recommendation DOCX with ranked resources and a weekly usage plan.
- `scripts/learning-resource-recommender/validate_resource_recommendations_docx.py`: verify required sections, tables, Times New Roman, and plan content.
- `references/resources.json`: structured, general-audience resource catalog with skill, level, access, transcript, exercise, provider, and review metadata.

## JSON Recommendation Plan

```json
{
  "learner_goal": "IELTS Listening Band 7.0",
  "focus": "listening",
  "level": "B1-B2",
  "time_budget": "30 minutes/day",
  "rationale": "The learner needs transcript-supported listening and paraphrase review.",
  "recommendations": [
    {
      "rank": 1,
      "title": "BBC 6 Minute English",
      "url": "https://www.bbc.co.uk/learningenglish/english/features/6-minute-english",
      "category": "听力学习 / 播客资源",
      "fit": "Short episodes with learner-friendly topics and transcripts.",
      "how_to_use": "Listen once without transcript, then mark 5 paraphrases from the transcript.",
      "bring_back": "Three new phrases and one sentence you failed to catch."
    }
  ],
  "weekly_plan": [
    "Day 1-2: BBC 6 Minute English transcript listening.",
    "Day 3-4: One IELTS listening section and error notebook."
  ]
}
```

```bash
python scripts/learning-resource-recommender/extract_learning_resource_catalog.py --skill listening --level B2 --limit 12
python scripts/learning-resource-recommender/create_resource_recommendations_docx.py resource_recommendation_plan.json
python scripts/learning-resource-recommender/validate_resource_recommendations_docx.py ~/Desktop/IELTS_Resource_Recommendations_YYYYMMDD_HHMM.docx --plan-json resource_recommendation_plan.json
```

## Quality Bar

- Do not recommend more than seven resources at once.
- Do not treat general English resources as IELTS materials unless they train a concrete IELTS subskill.
- Include a use method, not just a URL.
- Use only catalog entries that satisfy its general-audience policy. Browse to verify availability when the resource is time-sensitive, paid, region-dependent, or likely to have changed since `lastReviewed`.
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall