Files
marqdo/scripts/migrate-v02-syntax.py
cflmy 9331af78e2 release(2.8.0): 合入 CHANGELOG/README/发版说明/skills prove 任务;CI 链接指向 doc/releases
- CHANGELOG.md:v2.8.0 条目(中英双语);
- README.md:版本行 2.7.1→2.8.0 + 愿景第 6 条(知识可证明);
- doc/releases/v2.8.0.md:双语发版说明(亮点/用法/已知限制);
- skills/marqdo-dev/index.mq.md:新增 prove 任务(路径/目录模式/
  require_lean/json;参数用 + 行声明升参,check 与 narrative-ratio 通过);
- 设计文档 §12.5 标记已合入;发版链接统一指向 doc/releases/v2.8.0.md。
2026-11-18 10:29:26 +08:00

62 lines
1.6 KiB
Python
Executable File

#!/usr/bin/env python3
"""One-shot migrate v0.2: params + `name`, foreach [`i`](`xs`)."""
from __future__ import annotations
import re
import sys
from pathlib import Path
ROOT = Path(__file__).resolve().parents[1]
SKIP_DIRS = {"man-test", "target", ".git", "node_modules"}
PARAM_RE = re.compile(
r"^(\s+)- ([A-Za-z_\u4e00-\u9fff][A-Za-z0-9_\u4e00-\u9fff]*)(=(.*))?\s*$"
)
FOREACH_RE = re.compile(r"^(\s*)- \[([^\]]+)\]\(([^)]+)\)\s*$")
def wrap_id(name: str) -> str:
name = name.strip()
if name.startswith("`") and name.endswith("`"):
return name
return f"`{name}`"
def migrate_line(line: str) -> str:
m = FOREACH_RE.match(line)
if m:
indent, item, coll = m.groups()
return f"{indent}- [{wrap_id(item)}]({wrap_id(coll)})\n"
m = PARAM_RE.match(line)
if m:
indent, name, _, default = m.groups()
if default is not None:
return f"{indent}+ {wrap_id(name)}={default.rstrip()}\n"
return f"{indent}+ {wrap_id(name)}\n"
return line
def should_skip(path: Path) -> bool:
return any(part in SKIP_DIRS for part in path.parts)
def main() -> int:
changed = 0
for path in sorted(ROOT.rglob("*.mq.md")):
if should_skip(path):
continue
text = path.read_text(encoding="utf-8")
lines = text.splitlines(keepends=True)
out = [migrate_line(ln) for ln in lines]
new_text = "".join(out)
if new_text != text:
path.write_text(new_text, encoding="utf-8")
print(path.relative_to(ROOT))
changed += 1
print(f"migrated {changed} files")
return 0
if __name__ == "__main__":
sys.exit(main())