research-workflow

Research Idea Workflow Skill | 科研思路工作流技能

Claude Code Skill · Materials Engineering Focus · Bilingual (EN/ZH)

---

Overview | 概述

This skill guides materials engineering researchers through four structured stages — from a raw idea to a fully planned experiment — with human-in-the-loop confirmation at each critical checkpoint.

本技能引导材料工程科研人员完成从模糊想法到完整实验方案的四阶段结构化流程，在每个关键节点提供人工确认机会。

Trigger / 触发方式:

• Claude Code: invoke this skill file, then describe your research idea in natural language
• Codex CLI: see AGENTS.md in this directory

Pipeline Overview / 流程概览:

Stage 1: Topic Refinement       → [CHECKPOINT 1] → [TOKEN REPORT 1]
Stage 2: Urgency Assessment     → [CHECKPOINT W?] → [TOKEN REPORT W] → [CHECKPOINT 2] → [TOKEN REPORT 2]
Stage 3: Technical Route Eval   → [CHECKPOINT W?] → [TOKEN REPORT W] → [CHECKPOINT 3] → [TOKEN REPORT 3]
Stage 4: Experiment Planning    → Final outputs → [TOKEN REPORT 4] → [TOTAL SUMMARY]

Citation Verification runs continuously across Stages 2–3
WARN detected → [CHECKPOINT W] Human review of flagged references

---

Token Tracking Protocol | Token 消耗追踪协议

At every CHECKPOINT and after every stage, Claude MUST run the token tracker. 在每个确认节点和每个阶段结束后，Claude 必须运行 token 追踪器。

How to Estimate Tokens | 如何估算 Token 数

Claude should estimate tokens from the current stage's conversation: Claude 应从当前阶段的对话内容估算 token 数：

Input tokens  ≈ sum of all USER messages in this stage ÷ 4 (English) or ÷ 2 (Chinese/mixed)
Output tokens ≈ sum of all ASSISTANT messages in this stage ÷ 4 (English) or ÷ 2 (Chinese/mixed)

For a mixed EN/ZH workflow, use ÷ 3 as a practical approximation.
中英混合工作流实践中可统一使用 ÷ 3 作为近似值。

Token Report Command | Token 报告命令

python research-workflow/scripts/token_tracker.py \
  --log \
  --stage <STAGE_ID> \
  --input <INPUT_TOKEN_ESTIMATE> \
  --output <OUTPUT_TOKEN_ESTIMATE> \
  --model <MODEL_NAME>

# Stage IDs: 0 (setup), 1, 2, 3, 4, W (citation checkpoint)
# Model names: claude-sonnet-4-6 | claude-opus-4-6 | claude-haiku-4-5 | gpt-4o | gpt-4.1
# Run --list-models to see all options and current pricing