需要查询、浏览或分析西班牙立法及其历史修订时，使用…

适用于在 legalize-es 仓库中检索西班牙法律、按主题/类型/状态筛选、读取具体条文、查看任意历史版本并比较立法改革差异。

适用场景

解决思路

1. 克隆完整仓库：运行 `git clone https://github.com/legalize-dev/legalize-es.git`，然后 `cd legalize-es`；法律文件位于 `spain/` 目录。若只需要当前状态，运行 `git clone --depth 1 https://github.com/legalize-dev/legalize-es.git`。
2. 识别文件结构：`spain/` 下每部法律是一个 `.md` 文件，以 BOE 标识符命名，例如 `BOE-A-1978-31229.md`（西班牙宪法）、`BOE-A-1995-25444.md`（刑法）、`BOE-A-2015-11430.md`（劳动者章程）、`BOE-A-2000-323.md`（民事诉讼法），共 8600+ 部法律。
3. 读取 YAML frontmatter：文件开头包含 `titulo`、`identificador`、`pais`、`rango`、`fecha_publicacion`、`ultima_actualizacion`、`estado`、`fuente`；`rango` 可为 `constitucion`、`ley-organica`、`ley`、`real-decreto-ley`、`real-decreto-legislativo`；`estado` 可为 `vigente` 或 `derogado`。
4. 按主题查找法律：搜索 frontmatter 标题用 `grep -rl "trabajo" spain/ | head -20`；搜索正文关键词用 `grep -rl "huelga" spain/`；不区分大小写搜索概念用 `grep -rli "protección de datos" spain/`。
5. 读取特定条文：用 `grep -A 20 "Artículo 18" spain/BOE-A-1978-31229.md` 查找第 18 条；用 `grep -B 10 -A 30 "Artículo 135" spain/BOE-A-1978-31229.md` 带前后文查找第 135 条。
6. 按 BOE 标识符查找法律：已知 ID 时运行 `cat spain/BOE-A-1995-25444.md`；按部分 ID 查找运行 `ls spain/ | grep "BOE-A-1995"`。
7. 按法律类型或状态筛选：列出所有组织法 `grep -rl 'rango: "ley-organica"' spain/`；列出当前有效法律 `grep -rl 'estado: "vigente"' spain/`；列出已废止法律 `grep -rl 'estado: "derogado"' spain/`。
8. 查看一部法律的全部改革：`git log --oneline -- spain/BOE-A-1978-31229.md`；带日期 `git log --format="%h %ad %s" --date=short -- spain/BOE-A-1978-31229.md`；查看完整提交消息（含改革来源 URL）`git log -- spain/BOE-A-1978-31229.md`。
9. 比较两个版本：查看特定改革提交 `git show 6660bcf -- spain/BOE-A-1978-31229.md`；比较两个提交 `git diff 6660bcf^..6660bcf -- spain/BOE-A-1978-31229.md`；比较两个日期 `git diff $(git rev-list -1 --before="2011-01-01" HEAD) $(git rev-list -1 --before="2012-01-01" HEAD) -- spain/BOE-A-1978-31229.md`。
10. 读取历史版本：查看截至某日期的文本 `git show $(git rev-list -1 --before="2010-01-01" HEAD):spain/BOE-A-1978-31229.md`；查看指定提交的文本 `git show abc1234:spain/BOE-A-1978-31229.md`。
11. 查找特定文本何时加入或移除：用 `git log -S "estabilidad presupuestaria" -- spain/BOE-A-1978-31229.md` 找引入该文本的提交；用 `git log -G "límite de déficit estructural" --oneline -- spain/BOE-A-1978-31229.md` 找修改该短语的提交。
12. Shell 脚本提取所有法律标题：遍历 `spain/*.md`，对每个文件用 `grep 'identificador:' "$file" | head -1 | sed 's/.*: "//;s/".*//'` 提取 ID，用 `grep 'titulo:' "$file" | head -1 | sed 's/.*: "//;s/".*//'` 提取标题，输出 `"$id | $title"`。
13. Shell 脚本查找某日期后更新的法律：设置 `TARGET_DATE="2023-01-01"`，遍历包含 `ultima_actualizacion:` 的文件，用 `grep 'ultima_actualizacion:' "$file" | head -1 | grep -o '[0-9]\{4\}-[0-9]\{2\}-[0-9]\{2\}'` 提取日期，若 `"$date" > "$TARGET_DATE"` 则输出 `"$date $file"`，最后 `sort -r`。
14. Python 解析法律 frontmatter：定义 `parse_law(filepath)`，以 `encoding='utf-8'` 读取内容；若以 `---` 开头，用 `content.split('---', 2)` 取三段，用 `yaml.safe_load(parts[1])` 得到 metadata，`parts[2].strip()` 得到 body，返回 `metadata, body`。
15. Python 列出有效法律：遍历 `spain` 下 `.md` 文件，调用 `parse_law`，若 `meta.get('estado') == 'vigente'`，收集 `identificador`、`titulo`、`rango`、`ultima_actualizacion`；按 `ultima_actualizacion` 倒序排序并输出前 10 条。
16. Python 通过 Git 获取改革历史：定义 `get_reform_history(boe_id)`，对 `spain/{boe_id}.md` 运行 `git log --format=%H|%ad|%s --date=short -- <filepath>`，把每行按 `|` 拆成 `hash`、`date`、`subject` 并返回列表。
17. Python 比较法律两个版本：定义 `diff_law_versions(boe_id, commit_before, commit_after)`，对 `spain/{boe_id}.md` 运行 `git diff {commit_before}..{commit_after} -- <filepath>` 并返回 stdout；定义 `get_law_at_date(boe_id, date_str)`，用 `git rev-list -1 --before={date_str} HEAD` 找 revision，再用 `git show {rev}:{filepath}` 返回该日期文本。
18. Python 跨所有法律搜索：定义 `search_laws(query, laws_dir='spain', rango=None, estado='vigente')`，用 `re.compile(query, re.IGNORECASE)`；遍历 `.md` 文件，按 `estado: "..."` 和 `rango: "..."` 过滤 frontmatter；统计匹配次数，提取 `titulo` 和首个匹配上下文，按匹配次数倒序返回。
19. 工作流 1 研究法律主题：先 `grep -rl "protección de datos personales" spain/ > relevant_laws.txt`；再遍历文件提取 `titulo:`；最后 `grep -rl 'rango: "ley-organica"' spain/ | xargs grep -l "protección de datos"` 找主要组织法。
20. 工作流 2 追踪特定改革：先 `git log -S "estabilidad presupuestaria" --oneline -- spain/BOE-A-1978-31229.md`；再用 `git show <commit-hash> -- spain/BOE-A-1978-31229.md` 查看变更；最后 `git show --format="%B" <commit-hash> | head -10` 读取官方来源。
21. 工作流 3 导出法律到 JSON：遍历 `spain` 下 `.md` 文件，以 `encoding='utf-8'` 读取；若以 `---` 开头，用 `content.split('---', 2)` 和 `yaml.safe_load(parts[1])` 解析元数据，把 `filename` 加入 `meta`；收集所有 `laws` 后用 `json.dump(laws, f, ensure_ascii=False, indent=2, default=str)` 写入 `laws_index.json`，并打印导出数量。
22. 仓库太大无法克隆时：使用浅克隆 `git clone --depth 1 https://github.com/legalize-dev/legalize-es.git` 只取当前状态，或用 `git clone --depth 50 ...` 限制历史。
23. 浅克隆后 `git log` 无历史时：运行 `git fetch --deepen=100` 获取更多历史，或运行 `git fetch --unshallow` 获取完整历史。
24. Windows 编码问题时：运行 `git config core.quotepath false` 和 `git config i18n.logoutputencoding utf-8`；在 Python 中始终使用 `encoding='utf-8'` 打开文件。
25. 没有 BOE ID 时查找法律：用 `grep -ril "enjuiciamiento civil" spain/ | head -5` 按不区分大小写部分标题搜索；或只在 frontmatter 中搜索 `grep -rl "Ley de Enjuiciamiento Civil" spain/`。
26. 核对数据来源与许可：立法内容为公共领域，来自 BOE Open Data API；仓库结构、元数据和工具为 MIT License；每部法律官方来源见 frontmatter 的 `fuente:` 字段；该项目属于 Legalize 多国项目，未来提供 legalize.dev API。

适用边界 · 注意事项

• 不适用于非西班牙立法或不在 legalize-es 仓库中的法律数据。
• 浅克隆只保留当前状态，无法进行完整历史 diff、改革时间线和历史版本读取。
• 法律内容虽来自 BOE 公共数据，但不应作为正式法律意见；需以 `fuente:` 指向的 BOE 官方文本为准。