mcpField
N
nsfc-schematic

nsfc-schematic

github.com/huangwb8Design & UI3.0k79 installsUpdated 2w ago
Repository

About nsfc-schematic

nsfc-schematic is a research communication skill for turning mechanism chains, algorithm architectures, module relationships, or experimental loops into editable, embeddable diagrams. It defaults to drawio rendering and evaluates structure, visuals, and readability across multiple rounds.

Key features

  1. 01Plan diagrams from specs, proposals, or descriptions
  2. 02Generate drawio, PDF, SVG, and PNG files
  3. 03Validate XML and run multi-round evaluation
  4. 04Check structure, visuals, and readability
  5. 05Create PNG-only images when explicitly requested

Use cases

  1. 01Diagram a research mechanism chain or algorithm architecture
  2. 02Show module relationships and experimental loops
  3. 03Iteratively review diagram layout and connections

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/huangwb8/chineseresearchlatex --skill nsfc-schematic

After installing, type/nsfc-schematicin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

CHANGELOG.md
config.yaml
README.md
assets/
color_schemes.yaml
references/
design_principles.md
plan_template.md
references/models/
templates.yaml
references/spec_examples/
ai_critic_min.yaml
ccs_framework.yaml
seqccs_min.yaml
transformer.yaml
scripts/
ai_evaluate.py
ai_extract_tex.py
color_math.py
env_utils.py
evaluate_dimension.py
evaluate_schematic.py
extract_from_tex.py
generate_schematic.py
geometry.py
measure_dimension.py
measure_schematic.py
model_gallery.py
nano_banana_check.py
nano_banana_client.py
nano_banana_generate_png.py
plan_schematic.py
png_compactor.py
render_schematic.py
routing.py

Details

From the project README

NSFC 原理图生成器

与 bensz-collect-bugs 的协作约定

  • 当用户环境中出现因本 skill 设计缺陷导致的 bug 时，优先使用 bensz-collect-bugs 按规范记录到 ~/.bensz-skills/bugs/，严禁直接修改用户本地 Claude Code / Codex 中已安装的 skill 源码。
  • 若 AI 仍可通过 workaround 继续完成用户任务，应先记录 bug，再继续完成当前任务。
  • 当用户明确要求“report bensz skills bugs”等公开上报动作时，调用本地 gh 与 bensz-collect-bugs，仅上传新增 bug 到 huangwb8/bensz-bugs；不要 pull / clone 整个 bug 仓库。

定位

  • 把机制链、算法架构、模块关系或实验闭环画成可编辑、可嵌入的科研图。
  • 默认使用 drawio 生成 drawio/pdf/svg/png；只有用户明确要求 Nano Banana 图片模型时才允许切到 PNG-only。
  • 仅用于科研写作与表达优化，不代表评审口径。

输入

至少提供其一：

  • spec_file：结构化图规格文件，优先。
  • proposal_file：单个标书文件。
  • proposal_path：标书目录。

可选：

  • rounds
  • renderer
  • output_dir
  • config
  • style_ref_images
  • context：自然语言机制描述，供规划模式生成草案
  • template_ref

输出

默认交付：

  • schematic.drawio
  • schematic.pdf
  • schematic.svg
  • schematic.png

隐藏中间产物写入 output_dir/.nsfc-schematic/：

  • optimization_report.md
  • spec_latest.yaml
  • config_used_best.yaml
  • evaluation_best.json
  • runs/run_*/round_*
  • ai/：stop_strategy=ai_critic 工作区
  • legacy/：历史残留收纳区

Nano Banana 模式仅交付：

  • schematic.png
  • schematic_compacted.png

硬规则

  • 开始前强制读取 config.yaml，以 renderer、layout、color_scheme、evaluation、planning、output 为单一真相来源。
  • 默认仅处理用户明确提供的文件或目录，不联网抓素材。
  • 默认保持 drawio 流程；未被用户点名时，不要切到图片模型。
  • 拥挤优先改 spec，不要优先缩字号；只有出现 overflow 风险时才减字号。
  • 配色问题优先改 kind 分配或结构，不用黑白方案掩盖结构错误。

主流程

1. 规划
  • 推荐首次使用时先走“规划 → 审阅 → 生成”。
  • 默认 planning_mode=ai：
    1. plan_schematic.py 生成规划请求
    2. 宿主 AI 产出 schematic-plan.md 和 spec_draft.yaml
    3. 复跑脚本做合法性校验
  • 若用户只给自然语言描述，也可直接以 --context 启动规划。
2. 生成
python3 nsfc-schematic/scripts/generate_schematic.py \
  --spec-file ./schematic_plan/spec_draft.yaml \
  --output-dir ./schematic_output \
  --rounds 5
  • 流程包括：解析 spec、生成 draw.io XML、XML 预检、渲染、主评估、多维度自检、导出 best round。
  • 如提供显式 edges，渲染器必须优先复现；否则按 layout.auto_edges 自动连线。
3. 评估与优化
  • 默认最多 5 轮，阈值与停止策略只看 config.yaml:evaluation。
  • 每轮至少输出：
    • evaluation.json
    • layout_debug.json
    • edge_debug.json
    • measurements.json
    • dimension_measurements.json
    • critique_structure.json
    • critique_visual.json
    • critique_readability.json
4. 可选：AI 自主闭环
  • 当需要宿主 AI 根据证据包决定下一轮时，启用 evaluation.stop_strategy: ai_critic。
  • 协议文件位于 .nsfc-schematic/ai/，主要包括：
    • ai_critic_request.md
    • ai_critic_response.yaml
    • ai_pack_round_XX/
5. 可选：Nano Banana PNG-only（Gemini / OpenAI gpt-image-2）
  • 只有用户明确要求时启用。
  • 先做连通性检查：
python3 nsfc-schematic/scripts/nano_banana_check.py

  • .env 中可通过 IMAGE_PROVIDER=openai 切到 OpenAI；未显式指定时，默认优先沿用既有 GEMINI_* 配置。

  • 再执行 PNG-only 生成：

python3 nsfc-schematic/scripts/generate_schematic.py \
  --renderer nano_banana \
  --spec-file ./schematic_plan/spec_draft.yaml \
  --output-dir ./schematic_output \
  --rounds 5

常用命令

# 规划
python3 nsfc-schematic/scripts/plan_schematic.py --proposal /path/to/proposal --output ./schematic_plan

# 生成
python3 nsfc-schematic/scripts/generate_schematic.py --spec-file ./schematic_plan/spec_draft.yaml --output-dir ./schematic_output --rounds 5

# 连通性检查
python3 nsfc-schematic/scripts/nano_banana_check.py

参考材料

  • config.yaml
  • references/plan_template.md
  • references/design_principles.md
  • references/models/templates.yaml
  • references/spec_examples/

Comments

Markdown supported