Hello-QM/catgo-LRG / server/catgo/workflow/skills/campaign
campaign-md-orchestration
VerifiedDrive a file-first, agent-in-the-loop computational campaign via a folder + markdown tree (no DB). Use when the user opts out of the visual workflow engine.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.2 KB |
| references/catgo-cli.md | markdown | 1.8 KB |
| scripts/INDEX.md | markdown | 1.8 KB |
| scripts/aggregate.py | script | 1011 B |
| scripts/archive.py | script | 1.8 KB |
| scripts/campaign_analysis.py | script | 4.3 KB |
| scripts/campaign_lib.py | script | 24.5 KB |
| scripts/campaign_lit.py | script | 3.3 KB |
| scripts/campaign_report.py | script | 1.6 KB |
| scripts/fetch_ref.py | script | 943 B |
| scripts/ingest_lit.py | script | 1.3 KB |
| scripts/make_report.py | script | 880 B |
| scripts/new_campaign.py | script | 932 B |
| scripts/poll.py | script | 798 B |
| scripts/submit_calc.py | script | 1.6 KB |
| scripts/test_campaign_analysis.py | script | 3.7 KB |
| scripts/test_campaign_lib.py | script | 21.8 KB |
| scripts/test_campaign_lit.py | script | 2.0 KB |
| scripts/test_campaign_report.py | script | 1.4 KB |
| scripts/test_entrypoints.py | script | 2.7 KB |
| scripts/test_skill_structure.py | script | 1.8 KB |
| scripts/test_vasp_sanity.py | script | 9.6 KB |
| scripts/vasp_sanity.py | script | 12.5 KB |
| templates/saa_her/plan.md | markdown | 1009 B |
scripts/campaign_lit.py
View on GitHub"""Literature ingestion: MinerU PDF->md, GitHub repo pointers, skill extraction.
Grounds plan/brainstorm in real sources and mines reusable recipes. MinerU is
optional — invoked through campaign_lib._run so it is mockable and degrades with
a clear install hint when absent.
"""
from __future__ import annotations
import tempfile
from pathlib import Path
import campaign_lib as cl
def _append_index(index_path: Path, line: str) -> None:
if not index_path.is_file():
index_path.parent.mkdir(parents=True, exist_ok=True)
index_path.write_text(
cl.tldr_header("literature/", "papers + repos + extracted-skills") + "\n",
encoding="utf-8",
)
with index_path.open("a", encoding="utf-8") as fh:
fh.write(line + "\n")
def ingest_repo(project, url: str, purpose: str = "", commit: str = "") -> Path:
proj = Path(project).expanduser()
slug = cl.slugify(url.rstrip("/").split("/")[-1].replace(".git", ""))
d = proj / "literature" / "repos" / slug
d.mkdir(parents=True, exist_ok=True)
(d / "POINTER.md").write_text(
cl.tldr_header(f"repo: {slug}", purpose or url)
+ f"\nurl: {url}\ncommit: {commit}\npurpose: {purpose}\n",
encoding="utf-8",
)
_append_index(proj / "literature" / "INDEX.md", f"- `repos/{slug}/` — {purpose or url}")
return d / "POINTER.md"
def append_extracted_skill(project, title: str, body: str) -> Path:
proj = Path(project).expanduser()
f = proj / "literature" / "extracted-skills.md"
if not f.is_file():
f.parent.mkdir(parents=True, exist_ok=True)
f.write_text(
cl.tldr_header(
"extracted skills", "reusable recipes mined from literature/repos"
) + "\n",
encoding="utf-8",
)
with f.open("a", encoding="utf-8") as fh:
fh.write(f"\n## {title}\n{body}\n")
return f
def mineru_convert(pdf_path, out_dir) -> Path:
"""Run MinerU on a PDF; return the produced .md. Clear error if absent."""
try:
rc, _, err = cl._run(["mineru", "-p", str(pdf_path), "-o", str(out_dir)])
except FileNotFoundError:
raise cl.CampaignError(
"MinerU not installed — `pip install mineru` (or `magic-pdf`). "
"PDF ingest needs it; or drop a converted paper.md in literature/papers/."
)
if rc != 0:
raise cl.CampaignError(f"mineru failed: {err.strip() or f'rc={rc}'}")
mds = sorted(Path(out_dir).rglob("*.md"))
if not mds:
raise cl.CampaignError(f"mineru produced no .md in {out_dir}")
return mds[0]
def ingest_pdf(project, pdf_path, converter=mineru_convert) -> Path:
proj = Path(project).expanduser()
slug = cl.slugify(Path(pdf_path).stem)
pdir = proj / "literature" / "papers" / slug
pdir.mkdir(parents=True, exist_ok=True)
with tempfile.TemporaryDirectory() as tmp:
md = converter(pdf_path, tmp)
(pdir / "paper.md").write_text(
Path(md).read_text(encoding="utf-8"), encoding="utf-8"
)
(pdir / "notes.md").write_text(
cl.tldr_header(f"notes: {slug}", "key settings/method/findings (fill in)") + "\n",
encoding="utf-8",
)
_append_index(proj / "literature" / "INDEX.md",
f"- `papers/{slug}/` — <relevance; fill in>")
return pdir / "paper.md"
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |