Repo Release Curation
Use this skill when asked to tidy, restructure, or package a near-publication repository for open-source release while preserving reproducibility.
Workflow
- •
Confirm preservation scope
- •Always keep:
acl26_instructDiff/(paper source),eval/,data/. - •Confirm any other keep/delete constraints before removing files.
- •Always keep:
- •
Minimize root layout
- •Target root:
acl26_instructDiff/,configs/,data/,eval/,src/,README.md,requirements.txt,setup.py,pyproject.toml,.gitignore. - •Move all code into
src/and adjust imports accordingly.
- •Target root:
- •
Consolidate tools
- •Merge plotting/analysis into
src/<tool_pkg>/analysis/. - •If utility helpers exist, merge into package
__init__.pyor a single module to reduce file count.
- •Merge plotting/analysis into
- •
Packaging
- •Add
requirements.txt,setup.py, andpyproject.toml. - •Provide
console_scriptsentry for CLI (instdiff). - •Ensure
pip install -e .works without extra steps.
- •Add
- •
Docs (bilingual)
- •Write a single
README.mdwith Chinese + English sections. - •Include pipeline overview, quick start, config usage, and actual experiment results.
- •Reference paper figures using local assets.
- •Write a single
- •
Configs and outputs
- •Keep configs under
configs/<domain>/. - •Default outputs go to
runs/and are ignored via.gitignore.
- •Keep configs under
- •
AI trace removal
- •Remove assistant-specific logs or meta files.
- •Remove temporary logs or internal notes not needed for users.
Checks
- •
pip install -e .installsinstdiffCLI. - •
README.mdis the only root doc, bilingual, and includes results. - •Root contains only required top-level folders.
- •
eval/anddata/are preserved untouched.