---
name: willoscar/thesis-workspace-init
source: https://app.decimal.ai/s/willoscar-thesis-workspace-init@1/SKILL.md
source_sha256: 1c964124df6e
---

# Thesis Workspace Init

初始化一条**中文毕业论文重构流程**所需的工作区，而不是只复制通用 workspace 模板。

这个 skill 负责四件事：

1. 检查材料是否放在对的位置  
2. 明确写出“当前还缺什么 / 哪些位置异常 / 哪些需要用户确认”  
3. 建立毕业论文专用中间层目录与初始文件  
4. 生成材料盘点与待补信息清单

## Inputs

建议至少具备以下材料中的一部分：

- 学校模板或现有论文仓库
- `main.tex`
- 已有 `chapters/*.tex`
- `pdf/` 下的已发表 / 已投稿论文
- `Overleaf_ref/` 下的源稿或修回稿
- `references/` 下的 `bib` / 样式文件
- 题目、学号、年份等基础元信息

## Outputs

- `codex_md/material_index.md`
- `codex_md/material_readiness.md`
- `codex_md/missing_info.md`
- `codex_md/question_list.md`
- `codex_md/00_thesis_outline.md`
- `claude_md/review_checklist.md`
- `tmp_layout/`
- `tmp_layout2/`
- `mermaid/`（位于 `codex_md/mermaid/`）

## Load Order

Always read:

- `references/overview.md`
- `references/material-placement.md`

Machine-readable contract:

- `assets/workspace_contract.json`

## Workflow

1. 检查是否已经存在可用工作区
- 如果核心中间工件已经齐全，只补缺，不重置

2. 盘点材料放置位置
- 对照 `references/material-placement.md`
- 标出“已有 / 缺失 / 位置异常 / 待人工确认”

3. 初始化毕业论文专用中间层
- 建立 `codex_md/`、`claude_md/`、`tmp_layout/`、`tmp_layout2/`
- 生成最小工作文件骨架

4. 写出材料盘点、就绪度和缺口清单
- `codex_md/material_index.md`
- `codex_md/material_readiness.md`
- `codex_md/missing_info.md`

5. 生成本轮工作入口
- `codex_md/question_list.md`
- `codex_md/00_thesis_outline.md`

## Script

### Quick Start

- `uv run python .codex/skills/thesis-workspace-init/scripts/run.py --workspace <workspace>`

### All Options

- `--workspace <dir>`

### Notes

- 当前脚本只做**目录与骨架文件**初始化，不负责正文抽取与重构。
- 如果还没有标准 workspace，可以先使用现有 `workspace-init`，再运行这个 skill 补齐毕业论文专用结构。

## Block Conditions

遇到以下情况应停止并先修正：

- 没有任何可用模板或现有论文工程
- `main.tex` 完全缺失且也没有可替代的源稿入口
- 材料散落且无法判断哪个目录才是权威来源