Triggers & routing
- Trigger: Thesis question list, thesis question list, thesis revision list, this round's goals, structural issue sorting, review issue organization.
- Use when: You already have a batch of materials or the previous round's review results, and you need to clarify exactly what to revise and what not to revise in this round, and provide a unified entry point for subsequent restructuring and compilation rechecks.
- Skip if: Currently you are only making one-off local wording changes, and no new round of structural/evidence/compilation issues has formed.
- Network: none.
- Guardrail: Do not write the main text here; do not write the issue list as a long essay; every issue must be actionable and verifiable.
This skill is responsible for maintaining the thesis process'scontrol plane document：
codex_md/question_list.md
It is not a memo, but the single entry point for this round of work.
Inputs
codex_md/material_index.mdcodex_md/missing_info.md- Existing
codex_md/*.md claude_md/review_checklist.md- latest compilation / review / self-check results
Outputs
codex_md/question_list.md
Load Order
Always read:
references/overview.mdreferences/question_entry_schema.mdreferences/examples_good.mdreferences/examples_bad.md
Machine-readable contract:
assets/question_list_contract.json
Workflow
- Collect issue sources
- Previous round's review
- Current compilation failures / warnings
- Structural issues
- Citation issues
- Style issues
- Consolidate into this round's issues
- Deduplicate
- Merge issues from the same source
- Distinguish structural issues / evidence issues / TeX issues / style issues
- Prioritize
- Structure first
- Then evidence
- Then the delivery layer
- Finally polish
- Write standard issue entries
- Issue description
- Involved chapters
- Why it is an issue
- Revision direction
- Whether multi-agent discussion is needed
- Acceptance criteria
Script
Quick Start
uv run python .codex/skills/thesis-question-list/scripts/run.py --workspace <workspace>
Notes
- The current script is only responsible for generating the issue list skeleton when it is missing.
- The actual entry content is still filled in and maintained by you based on this round's issues.