阶段 F:代码迭代与模型优化
user_requirements.md 优先级:
docs/user_requirements.md中记录的所有用户约束优先于本 skill 提示词中的任何默认指令。每次调用前必须先读取该文件。
整体流程与产物
ResearchPilot-Skills 将完整学术研究拆分为七个阶段,每个阶段是独立的 skill。当前 skill 是其中一环。
七阶段链条
| Skill | 阶段 | 主要产物 |
|---|---|---|
/research[A]-exploration |
方向探索与调研 | docs/idea_report.md Part 1 |
/kim-ccf-research-idea |
Idea 深化 | docs/idea_report.md Part 2 |
/kim-ccf-research-experiment |
实验设计 | docs/idea_report.md Part 3 |
/research[D]-implementation |
实现设计 | docs/implementation.md |
/research[E]-coding |
编码 | code/ + docs/dev_log.md |
/research[F]-iteration |
代码迭代 | dev_log.md 迭代记录 |
/research[G.0]-plan |
论文规划 | 手稿架构注释 + notebooks/figures.ipynb |
/research[G.1]-method |
Method | 手稿 Method 章节 |
/research[G.2]-experiments |
Experiments | 手稿 Experiments 章节 |
/research[G.3]-abstract |
Abstract | 手稿 Abstract |
/research[G.4]-introduction |
Introduction | 手稿 Introduction |
/research[G.5]-related |
Related Works | 手稿 Related Works |
/research[G.6]-conclusion |
Conclusion + References | 手稿 Conclusion |
/kim-ccf-research-review |
整稿审阅 | 审阅报告 |
/research[G.8]-translate |
中→英翻译(仅中文版) | paper-en.tex |
项目目录结构
docs/
idea_report.md # Part 1(阶段 A)/ Part 2(阶段 B)/ Part 3(阶段 C)
implementation.md # 编码指南(阶段 D)
dev_log.md # 开发日志(只追加,不删除)
user_requirements.md # 用户约束,由 Claude 通过对话收集
papers/ # 下载的论文 PDF 或摘要 TXT
manuscripts/ # 阶段 G 论文稿件
code/
src/models/{model}.py / baseline/
src/data/ / src/train.py / src/evaluate.py / src/utils/
scripts/ # nohup shell 脚本
configs/
data/ / results/ / logs/
README.md / requirements.txt
命令
/research[F]-iteration
命令后可跟可选的自然语言指令,AI 会将其作为本次调用的额外约束或补充说明优先处理。
阶段 F 流程概览
F-1 诊断分析(读 dev_log.md + results/ + idea_report.md,给出诊断报告)
F-2 确认回溯范围(只改超参 / 改模型架构 / 改实验设计)
F-3 更新设计文档(先改文档再改代码,不得跳过)
F-4 编码改动(每改一个文件追加 dev_log 迭代记录)
F-5 验证(运行实验,追加结果到 dev_log)
F-6 判断是否继续迭代(循环 F-1,或进入下一阶段)
详细执行步骤见 references/phase-F.md。
硬性约束
- dev_log.md 只追加,不删除:每一次代码修改都必须追加新的日志条目。
- 必须先读取
dev_log.md、results/数据和idea_report.md再给出诊断,不得凭空判断。 - 改动范围必须经用户确认,先更新设计文档(
idea_report.md/implementation.md),再修改代码,不允许只改代码跳过文档更新。 - 若改了模型架构(Method),消融设计若随之变化,必须同步更新 Part 3。
references/template-flexibility.md中的规则优先于任何具体模板指令。
本阶段完成后
效果满意时:
阶段 F 完成。共迭代 {N} 轮,最终结果已记录在 dev_log.md。
→ 请使用 `/research[G.0]-plan` 进入论文规划阶段。
参考文件
- 详细流程:
references/phase-F.md - 模板灵活性规则:
references/template-flexibility.md