SuperAPI AI 工具集

format-markdown

写作与研究

查看项目

更新于 10-15 17:19

技能介绍

format-markdown(来源 arthurzakirov/systemsmith,URL https://www.skills.sh/arthurzakirov/systemsmith/format-markdown)是一个 Markdown 处理技能,用于创建、编辑、审阅、重构或重写 Markdown 工件,同时保留含义、有效语法、可导航性和可人工审阅性。

用途:在需要整理 Markdown 文档时使用,尤其当输出会被机器消费的 AGENTS.md、SKILL.md 等文件,应兼顾智能体正确使用与人类审阅导航。

主要能力:按信息呈现设计选择表格、列表、层级、散文、图示等表示方式;按相关性优先的信息设计进行信息筛选、抽象分层、路由和渐进披露;当来源是原始笔记、口述、转录或头脑风暴时,恢复其概念结构而非按来源顺序照搬;当输出包含当前状态值、快照、文件树、版本、路径等易漂移数据时,应用 living-artifacts 思路。

保留规则:保留已有全部关键信息、细微差别和示例;在不改变含义时修正拼写、语法、转录噪声、病句和错误 Markdown 语法;不虚构缺失内容;仅在提升清晰度且不改变含义时重排内容;需保留但不作为文档内容的额外说明可用 HTML 注释。

Markdown 规则:当 $ 字面量是来源语义一部分时保留;目标需要时保持 YAML/frontmatter 有效;使用有效标题层级,不因视觉大小跳级;对仓库、文件夹、文件、命令、函数、变量、配置键等字面技术标识适当使用行内代码;维护中的文档若存在真实目标,应将具体文件引用改为正确相对链接;保持代码围栏语法有效并保留已知语言标识;当字面字符会被错误解析时转义或重构。

自检:含义保留、无编造事实、Markdown 按预期解析、frontmatter 和代码围栏有效、可解析目标的文件路径有意义可点击、未解析目标应标明而非伪装成链接、机器消费的 Markdown 仍便于人工审阅导航。表示与相关性/披露规则来自专用技能,不在此重新定义;转换原始想法时按 thoughts-to-artifact 保留示例与细微差别。

使用方式与限制:资料仅说明技能触发与处理规则,暂未提供具体安装命令、调用参数、收费或价格信息。