Skip to content

zhouxzh/dsh-writing-suite

v1.2.0MIT

Unified DSH writing suite for tutorial manuscripts, academic papers, patent technical disclosures, LaTeX builds, evidence, and neural-network diagram audits.

ascend310b-code-docs

Ascend310 代码参考文档写作与维护。用于 samples 下源码的 docstring、接口注释、API/CLI 参考、最小调用示例、脚本和测试参数说明,以及 README 中的函数签名或 CLI 参考段落;部署、架构、配置操作与验证文档交给 ascend310b-writing-docs。要求从代码、测试和板端事实出发,拒绝编造 API,不把代码参考写成案例教材或论文。

ascend310b-curriculum-planning

Ascend310 教材的课程计划与内容映射。用于规划第1章至第10章、案例1至案例9、样例代码和 Presentation 的学习目标、先修关系、评估证据和教学顺序;要求 observable objectives、可复现实验和 310B 硬件边界,不改变冻结标题,不虚构板端结果。

ascend310b-writing

Ascend310 教材写作总路由和跨对象发布门。用于判断理论章节、实践案例、课件、工程 docs、代码参考、课程计划、VuePress、LaTeX、Markdown、Graphviz、神经网络框图或中文学术润色应加载哪些专用 skill,并统一冻结命名、证据边界、读者稿边界、人工验收和推送条件。

ascend310b-writing-academic

Ascend310 教材的学术写作、正式出版润色与论文式论证。用于章节/案例的理论框架、问题陈述、相关工作、方法、实验、结果、讨论、限制、引用和可复现证据,也用于已有教材正文的润色、去 AI 味、压缩和读者化改写;执行作者的中西文无字面空格规范,强调读者问题、claim-evidence-citation 和 Revision notes,不把教材写成产品宣传稿,也不把论文生成流程冒充真实实验。

ascend310b-writing-case

Ascend310 实践案例教材写作。用于案例1至案例9的 src/experiment 正文、样例入口和教学验收;sidebar 由 ascend310b-writing-vuepress 维护;要求面向初学者先讲基础知识与必要理论,再以最小示范、分步实验、证据解释和迁移任务递进,使用灵活语义标题,不把部署手册、发布报告或板端日志直接当成教材;案例发布仍必须从 GitHub 固定 commit 获取程序、从 Hugging Face 固定 revision 下载模型。

ascend310b-writing-docs

Ascend310 代码工程文档与测试问题台账写作。用于 samples/caseN 的 README、docs/ 下的部署/API/配置/验证/限制文档、统一 NN-troubleshooting.md 问题记录、代码入口与测试命令说明、证据记录和跨案例工程索引;测试设备/服务/模型出问题后必须使用本 skill 登记复现、证据、根因与回归;不用于理论章节、9 个案例教材正文或 Presentation 课件。

ascend310b-writing-dot

Ascend310 教材 Graphviz DOT 图写作与画布适配。用于系统架构图、数据流图、程序流程图、模块依赖图和生成 PNG/SVG;要求按网页、PDF、Presentation 16:9 的尺寸限制画布,保留 .dot 源、正确引用生成图、检查 Graphviz 语法与版面,不手改生成图片。

ascend310b-writing-latex

Ascend310 教材 LaTeX/PDF 写作与渲染验收。用于 convert-vuepress.sh、latex/ 生成物、XeLaTeX 日志、缺字形、未定义引用、锚点丢失、PDF 产物新鲜度和构建失败;必须改 Markdown 源,不手改生成的 latex/*.tex 或 PDF。

ascend310b-writing-markdown

Ascend310 教材 Markdown 写作规范。用于 CommonMark/GFM 语法、frontmatter、标题层级、锚点、链接、图片、表格、代码块、中文标点、中西文无字面空格规范、markdownlint 规则和 Markdown 卫生检查;不用于 VuePress 配置、LaTeX 生成物或课件排版。

ascend310b-writing-neural-diagram

Audit TikZ neural-network and encoder-decoder diagrams for connector paths crossing module or text boxes. 用于绘制、审查或修复神经网络结构图、编码器—解码器框图、残差连线和跨列注意力连线;检查几何冲突与 sidecar 漂移。

ascend310b-writing-presentation

Ascend310 教材演示文稿写作与验收。用于 src/presentation 下 Marp 课件、主题、封面/目标/章节/正文/小结、讲师备注、来源和真实浏览器版面检查;不用于理论章节、案例正文或代码工程 docs。

ascend310b-writing-theory

Ascend310 教材理论章节写作。用于新增、改写、重命名第1章至第10章及附录理论内容,维护 src/book、分区 README、冻结名、章节结构和理论教程的 Markdown/LaTeX/PDF 证据;sidebar 由 ascend310b-writing-vuepress 维护;不用于案例运行手册、代码 docs 或课件排版。

ascend310b-writing-vuepress

Ascend310 开源网页教材的 VuePress 站点模板与配置。用于 src/.vuepress 的主题、navbar、sidebar、base、frontmatter、静态资源、GitHub Pages 和 docs:dev/docs:build;改站点外壳、导航或网页模板时使用。不手改 dist/.temp/.cache,不把生成站点当成教材源,也不用本 skill 写案例正文或 Marp 课件。

diagram-design

为学术论文、技术报告和专利技术交底构建可编辑、可验证的系统图、流程图、状态图、时序图和连接关系图;负责图形工具选择、源文件、渲染命令和版面验收,不替代专利、论文或教材的领域写作规则。

nature-polishing

Polish, translate, or tighten existing evidence-frozen academic prose while preserving facts, terminology, and evidence boundaries. Use for 论文润色、学术翻译、正文精简, or manuscript LaTeX layout fixes. Use scientific-writing when new claims, sections, evidence, or the core argument must be created.

paper-cover-letter

期刊投稿与返修 cover letter(投稿信/附信)的 LaTeX 工作流。用于初投稿、major/minor revision 返修信,按 KOMA-Script 欧洲学术信函版式生成一页正式英文信,核对标题、稿号、作者、单位、邮箱、图页数与所有量化结论。触发词包括 cover letter、投稿信、附信、submission letter、revision letter。

paper-evidence

论文中的数字、表格与结论必须绑定到可追溯证据。当要写或改 Results/Discussion/Abstract、新增 claim、把实验结果写进正文、核对表格与正文数字、判断某个结论能否写、或处理 negative/failed 结果时使用;也用于区分 confirmatory、exploratory 与 validation-only 证据。

paper-latex-cn

中文论文 LaTeX 工作区的结构与排版约定(scrartcl + ctex + biblatex APA + XeLaTeX)。当新建论文工作区、调整 main.tex 前言、增删章节、修 overfull box、处理缺字形或未定义引用、或需要 make pdf 构建与排错时使用。

patent-disclosure

为专业专利代理师编写或审查发明专利技术交底书,采用由三份人工校准交底书提炼的九段式结构、段落写法、附图与表格规范,强制检查术语、可实现性、算法数据流程、实施例、图文和效果边界;不生成权利要求或正式申请文件。

reviewer-response-letter

审稿人回复意见(response letter / rebuttal letter)的 LaTeX 工作流。用于从作者 DOCX 回复稿迁移出点对点回复信,保持蓝色删除、红色新增的修订标记,按正文编号与排版复现公式,引用论文正式图片并独立编译,逐条核对审稿意见与答复。触发词包括 response letter、审稿意见回复、回复信、rebuttal、reviewer response。

scientific-writing

Drafts, revises, and audits scientific manuscripts or reports with explicit evidence provenance, reporting-guideline coverage, authorship accountability, confidentiality controls, and local consistency checks. Use for manuscript sections, references, declarations, tables, figures, or submission preparation when scientific accuracy and traceability matter.