academic-figure-workflow
Plan, generate, inspect, and refine academic figures from repositories, papers, draft notes, paper URLs, PDFs, or reference images. Supports fast-track draft-to-figure generation and user passthrough mode.
Azhi-ss · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add Azhi-ss/academic-figure-skills --skill academic-figure-workflow技能说明
name: academic-figure-workflow description: Plan, generate, inspect, and refine academic figures from repositories, papers, draft notes, paper URLs, PDFs, or reference images. Supports fast-track draft-to-figure generation and user passthrough mode. metadata: version: "1.6.0"
Academic Figure Workflow
Produce a grounded academic figure and a stable local artifact. Preserve the user's chosen backend, reference assets, style direction, review preference, and output scope.
Load only what the current stage needs:
- missing evidence →
references/missing-info-policy.md - palette/style fallback →
references/palettes.mdand, when installed,references/styles/ - Codex native image execution →
references/codex-image-workflow.md - render inspection →
references/render-audit.mdwhen present
Route inputs by inspected content
A URL is not automatically a repository. Inspect it first.
| Input | Route | Execution Behavior |
|---|---|---|
| Direct User Architecture (Passthrough) | ../academic-figure-designer/SKILL.md | Skip analyzers. User gave explicit nodes/flow; compile FigureSpec v1 and render directly. |
| Draft Notes / Outline / Partial Draft | ../academic-figure-draft-analyzer/SKILL.md | Draft-to-Figure Fast-Track. For rough notes, outlines, or sections without full results: focus on Figure 1 framework. |
| Complete Manuscript (Markdown / LaTeX / PDF / URL) | ../academic-figure-draft-analyzer/SKILL.md | Full Planning. For complete papers with experiments/results: multi-figure strategy, claim verification, and constraints. |
| Repository path or repository URL | ../academic-repo-analyzer/SKILL.md | Extract semantic architecture graph; omit engineering plumbing (data loaders, trainers). |
| Paper plus repository | Hybrid | Paper/user defines narrative & topology; repository supplies parameter & dimension verification. |
| Reference figure or existing render | ../academic-figure-architecture-extractor/SKILL.md | Extract transferable Style Grammar; drop reference's method labels and content. |
For an article URL, use an available web/browser/document reader to obtain the paper text, captions, and linked figures. For a PDF, use a PDF-capable reader for paper content and the architecture extractor only for figure images. If a sibling skill is missing, perform the minimum equivalent analysis and mark the degraded path.
Keep versioned internal artifacts
Store these as JSON-compatible objects. Do not make the user read them unless requested.
FigurePlan v1
schema: academic-figure/FigurePlan@1
source_revision, venue
sources[]: {kind, uri_or_absolute_path, revision_or_page, evidence}
figures[]: {
figure_id, figure_type, priority, communication_goal, claim_scope[], hero_element,
required_nodes[], required_connections[], authority_boundaries[], secondary_context[],
forbidden_claims[], forbidden_connections[], aspect_ratio, final_width_mm,
style_profile_hint, reference_assets[],
open_questions[], confidence, review_status: pending|confirmed|waived
}
Components and connections are semantic and evidence-backed. A code directory count is not a figure hierarchy or palette decision.
FigureSpec v1
schema: academic-figure/FigureSpec@1
figure_id, plan_revision, sources[], prompt (internal), aspect_ratio, final_width_mm
topology: {components[], connections[], groups[], authority_boundaries[]}
visible_text[], caption_notes[], layout
style_profile: classic-technical|pastel-airy-ui|illustrated-modular|reference-led
style_preset, style_source, style_grammar, semantic_color_roles
reference_images[]: checked absolute local paths or recent-conversation descriptors
conversation-reference transient status stays in the execution packet
must_not_claim[], forbidden_connections[], negative_constraints[]
prompt_review: requested|confirmed|waived
prompt_reviewed_sha256: required only when prompt_review is confirmed
workspace_root: absolute declaration that must match the runtime-trusted root
output_path: absolute path inside that root
The internal prompt is renderer input, not a required user-facing deliverable.
When prompt_review is waived, persist it only with the working artifacts and
never paste it into the chat response.
RenderAudit v1
schema: academic-figure/RenderAudit@1
figure_id, render_revision, image_path
checks: {topology, visible_text, hierarchy, overlap, background, aspect_ratio,
scaled_legibility, contrast, reference_fidelity}
pass, defects[], targeted_edit, semantic_edits_used, semantic_edits_remaining
Build the plan
Create the shortest FigurePlan that closes scientific ambiguity. When a reference exists, its transferable style grammar takes priority over venue stereotypes and preset defaults. Match composition, mark language, illustration level, region treatment, typography, spacing, arrow grammar, emphasis, and semantic color roles. Do not copy the reference's claims, labels, branding, or topology unless the user requested a redraw.
Use plan review only when unresolved choices would materially change the result, the user asks to review it, or required content is still a placeholder. Otherwise record review_status: waived and continue. An unrelated reply is never confirmation.
Select style without forcing a binary
Use the closest observable profile and record its canonical FigureSpec ID:
classic-technical: restrained strokes, exact topology, minimal illustration;pastel-airy-ui: white cards, light separation, color on tokens/curves;illustrated-modular: low-saturation filled regions, darker paired outlines/titles, one-level subcards, editorial or hand-drawn line art, asymmetric hero layout;reference-led: an override mode with at least one local or recent-conversation reference image; preserve the observed grammar whether it is technical, airy, illustrated, or a coherent combination.
Use style_preset for named library