hello-scholar

Use when the user asks to generate or refresh an architecture map, structure diagram, core call flow, local viewer assets, or runs ~map. Produces hello-scholar native architecture-map.json plus compact Markdown and Mermaid companion artifacts.

Use when the user asks to open the architecture viewer, view diagrams, inspect node evidence, export the local architecture map, or troubleshoot hello-scholar map view/export behavior.

实验分析命令，基于 experiment package、runs、metrics 和 evidence 形成结果解释与下一轮实验计划。

实现命令，把 plan package、change record 或 experiment package 落成代码、配置、文档或实验变更。

Use only when the user explicitly types ~map. Generates or refreshes the hello-scholar native architecture map by invoking the architecture-map workflow, then validates and points to the local viewer.

用于涉及编写或修改源码的日常编码任务。

当用户要求“create git commit”、“manage branches”、“follow git workflow”、“use Conventional Commits”、“handle merge conflicts”，或询问 Git 分支策略、版本控制最佳实践、Pull Request 流程时使用。该 skill 提供面向团队协作的完整 Git workflow 指南。

This skill should be used when the user asks where new files should live, says code or experiment outputs are scattered, adds experiment entrypoints, writes analysis/report artifacts, or needs Git branch/worktree separation for ML experiments.

当用户要求“analyze experimental results”、“run strict statistical analysis”、“compare model performance”、“generate scientific figures”、“check significance”、“do ablation analysis”，或提到要用严格统计与可视化解释实验数据时使用。该 skill 聚焦严格分析产物，不负责 Results 部分正文写作。

当用户要求 “write an experiment report”、“summarize experimental results”、“do experiment retrospection”、“write a results report”、“写实验总结报告” 或 “写实验复盘”，或提到希望把已完成实验产物整理成结构化、面向决策的研究报告时使用该 skill。它假设严格分析应首先由 `results-analysis` 完成。

Use when the user asks whether architecture docs are stale, whether docs and code still match, whether to validate before refresh, or when map validate needs semantic drift checks beyond schema validation.

Use when the user asks for call order, startup order, command lifecycle, request lifecycle, experiment lifecycle, skill routing, agent dispatch, or how execution moves through a codebase.

Use when the user asks to understand an unfamiliar repo, be onboarded, find entrypoints, map project structure, or identify where to change something. Produces a concise, evidence-backed mental model without writing project assets by default.

结构化规划命令，优先复用 planning-with-files，并把方案包写入 hello-scholar/plans。

验证总入口，对照 contract、diff、change record 和 experiment evidence 完成交付门槛检查。

将工作流切换为 Manus 风格的持久化 Markdown 文件，用于规划、进度跟踪和知识存储。适用于复杂任务、多步骤项目、研究任务，或用户提到 planning、organizing work、tracking progress、需要结构化输出时。

This skill must be used before claiming done/ready after plans, implementations, verification, prompt/workflow changes, viewer/UI changes, or skill/agent changes. It runs plan or delivery self-review, requires gaps to be fixed, and then reruns relevant checks before completion.

当用户要求 “verify code”、“run verification”、“check quality”、“validate changes”，或在创建 PR 前做质量确认时使用该 skill。它提供包括 build、type check、lint、tests、security scan 和 diff review 在内的完整验证流程。

检查并更新 hello-scholar 全局 memory 文件，使其与 skills、commands、agents 和 hooks 的变化保持同步。

Initialize hello-scholar project assets for the current repository. Use when the user explicitly types `~init` or asks to initialize hello-scholar records for a project; creates the project `hello-scholar/` directory if missing and ensures root `.gitignore` ignores `/hello-scholar/` and `/.hello-scholar/`.

当用户要求把实验结果写成论文叙述、解释图表发现、组织 ablation / failure case 文字、推荐实验图表表达，或将 metrics 转成谨慎的 result narrative 时使用。

当用户要求检查论文逻辑、段落连贯性、claim-evidence 对齐、Reviewer 视角快速审视、找论证漏洞，或判断 novelty / evidence / limitation 是否支撑结论时使用。

当用户要求 “review paper quality”、“check paper completeness”、“validate paper structure”、“self-review before submission”，或提到系统化论文质量检查时使用该 skill。它提供面向学术论文的完整质量保障清单。

当用户要求英文论文润色、中文论文润色、降低 AI 腔、改写得更自然、更像顶会论文、保持 LaTeX 和技术含义不变，或需要 publication-ready 学术表达时使用。

当用户要求中英互译、英文学术翻译、中文转 LaTeX 英文、英文论文段落译回中文核对，或需要保持术语、公式、citation 和 LaTeX 结构不变的双语学术翻译时使用。

当用户要求生成或润色 figure caption、table caption、图标题、表标题、visual abstract、论文架构图说明，或需要把实验图表叙述成 publication-ready caption 时使用。

为 NeurIPS、ICML、ICLR、ACL、AAAI、COLM 撰写 publication-ready 的 ML/AI 论文。用于从 research repo 起草论文、做 literature review、寻找 related work、验证 citation，或准备 camera-ready submission。包含 LaTeX template、citation verification workflow 和论文发现 / 评估标准。

当用户要求缩写、扩写、控制字数、压缩摘要、扩展论文段落、适配 page budget，或在不改变 LaTeX、事实和 claim 的情况下微调论文长度时使用。

Candidate 应用命令，用于审核并同步已有 skill / preference candidate；默认只 review/preview，确认后才 apply。

演化命令，基于 change、experiment、evidence 和 closeout 生成 skill / preference candidates，默认不应用。

轻量探索与方向比较，优先复用 research-ideation，不写项目资产也不进入实现。

当用户要求“debug this”、“fix this error”、“investigate this bug”、“troubleshoot this issue”、“find the problem”、“something is broken”、“this isn't working”、“why is this failing”，或直接报告 error / exception / bug 时使用。提供系统化调试流程和常见错误模式。

生成 session work log，检查是否需要更新 AGENTS.md，并清理临时文件。用于替代 session-summary 和 stop-summary hooks。

仅在创建需要 Factory 或 Registry 模式的新 registrable ML 组件时使用。

当用户要求 review diff 或 pull request、撰写 review comment、审计代码质量、建立 review 标准，或改进团队 code review 方式时使用。

hello-scholar 内部命令与 canonical skill 规范

创建具有辨识度、production-grade 且高设计质量的前端界面。当用户要求构建 web components、pages、artifacts、posters 或 applications 时使用该 skill，例如 websites、landing pages、dashboards、React components、HTML/CSS layouts，或需要 styling / beautifying 任意 web UI 时。生成有创意、精致且避免通用 AI 审美的代码和 UI 设计。

当用户提出 “review website design”、“check the UI”、“fix the layout”、“find design problems” 等请求时使用。该 skill 通过本地或远程页面的可视化检查识别并修复设计问题，覆盖 responsive design、accessibility、视觉一致性和布局破坏，并在源码层完成修复。

当用户要求协作文档、起草 proposal、编写 technical spec、创建 decision doc 或 RFC，或希望通过迭代合作来组织一份较大文档时使用。

当用户希望 Codex CLI 近似 Claude Code hook 行为、模拟 SessionStart 或 SessionEnd 检查、在危险操作前增加 preflight 守卫、自动触发 post-edit 验证，或在 Codex 中尽可能遵循类似 Claude Code hook 的安全工作流时使用该 skill。