Jobo16/ielts-buddy / skills/ielts-reading-review
ielts-reading-review
Verified根据阅读题目、用户答案和原文证据解释错因、同义替换与干扰项,开展精读或整理阅读词块;也可读取已提交 IELTS Buddy 练习或模考科目。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 1.3 KB |
| agents/openai.yaml | config | 257 B |
| manifest.json | config | 214 B |
| references/api-access.md | markdown | 1.1 KB |
| references/browser-routes.md | markdown | 587 B |
| references/intensive-reading/WORKFLOW.md | markdown | 2.5 KB |
| references/learning-data.md | markdown | 965 B |
| references/reading-lexicon/WORKFLOW.md | markdown | 6.0 KB |
| references/reading-review/WORKFLOW.md | markdown | 4.5 KB |
| references/review-records.md | markdown | 1.1 KB |
| references/skill-taxonomy.json | config | 1.5 KB |
| scripts/reading-lexicon/create_reading_lexicon_docx.py | script | 30.3 KB |
| scripts/reading-lexicon/extract_reading_docx.py | script | 3.5 KB |
| scripts/reading-lexicon/validate_reading_lexicon_docx.py | script | 6.4 KB |
| scripts/reading-review/create_reading_evidence_map_docx.py | script | 13.4 KB |
| scripts/reading-review/validate_reading_evidence_map_docx.py | script | 3.1 KB |
| scripts/simple_docx.py | script | 9.0 KB |
scripts/reading-lexicon/extract_reading_docx.py
View on GitHub#!/usr/bin/env python3
"""Extract readable IELTS Reading passage text from a DOCX."""
from __future__ import annotations
import argparse
import json
import re
from dataclasses import asdict, dataclass
from pathlib import Path
from xml.etree import ElementTree as ET
from zipfile import ZipFile
W_NS = "http://schemas.openxmlformats.org/wordprocessingml/2006/main"
W = f"{{{W_NS}}}"
def qn(tag: str) -> str:
return f"{W}{tag}"
def text_of(el: ET.Element) -> str:
parts: list[str] = []
for child in el.iter():
if child.tag == qn("t") and child.text:
parts.append(child.text)
elif child.tag == qn("tab"):
parts.append("\t")
elif child.tag == qn("br"):
parts.append("\n")
return "".join(parts)
def normalize_spaces(text: str) -> str:
return " ".join(text.split())
def direct_paragraphs(root: ET.Element) -> list[ET.Element]:
body = root.find(qn("body"))
if body is None:
return []
return [child for child in list(body) if child.tag == qn("p")]
def is_question_boundary(text: str) -> bool:
text = normalize_spaces(text)
lower = text.lower()
if re.match(r"^questions?\s+\d+(?:\s*[-–]\s*\d+)?\b", lower):
return True
if re.match(r"^(choose|complete|match|write)\b", lower) and len(text.split()) <= 18:
return True
markers = (
"true, false or not given",
"yes, no or not given",
"choose the correct letter",
"write the correct letter",
"complete the summary",
"reading passage questions",
)
return any(marker in lower for marker in markers)
def likely_title(paragraphs: list["Paragraph"]) -> str:
for para in paragraphs[:8]:
words = para.text.split()
if 2 <= len(words) <= 14 and not is_question_boundary(para.text):
return para.text
return Path(paragraphs[0].source_file).stem if paragraphs else "IELTS Reading Passage"
@dataclass
class Paragraph:
index: int
text: str
source_file: str
def extract_docx(path: Path) -> dict[str, object]:
with ZipFile(path) as zf:
root = ET.fromstring(zf.read("word/document.xml"))
paragraphs: list[Paragraph] = []
for index, paragraph in enumerate(direct_paragraphs(root), start=1):
text = normalize_spaces(text_of(paragraph))
if text:
paragraphs.append(Paragraph(index=index, text=text, source_file=str(path)))
passage: list[Paragraph] = []
for para in paragraphs:
if passage and is_question_boundary(para.text):
break
passage.append(para)
if not passage:
passage = paragraphs
article_text = "\n\n".join(para.text for para in passage)
return {
"source_file": str(path),
"title": likely_title(passage),
"article_text": article_text,
"passage_paragraph_indices": [para.index for para in passage],
"paragraphs": [asdict(para) for para in paragraphs],
"passage_paragraphs": [asdict(para) for para in passage],
}
def main() -> None:
parser = argparse.ArgumentParser(description=__doc__)
parser.add_argument("docx", type=Path)
parser.add_argument("--output", type=Path, default=None)
args = parser.parse_args()
result = extract_docx(args.docx)
text = json.dumps(result, ensure_ascii=False, indent=2)
if args.output:
args.output.parent.mkdir(parents=True, exist_ok=True)
args.output.write_text(text + "\n", encoding="utf-8")
print(args.output)
else:
print(text)
if __name__ == "__main__":
main()
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |