如何在 Claude Code 与其他 AI Agent 中启用 Quarkdown 内置的 agent skill

如何在 Claude Code 与其他 AI Agent 中启用 Quarkdown 内置的 agent skill【免费下载链接】quarkdown Markdown with superpowers: from ideas to papers, presentations, websites, books, and knowledge bases.项目地址: https://gitcode.com/GitHub_Trending/qu/quarkdownQuarkdown 随安装包附带了一个 agent skill以及一份完整的离线 wiki 和 stdlib API 参考副本目的是让 AI Agent 在生成.qd文档前先查阅官方文档而不是凭空猜测语法。这篇文章的任务就是把这个 skill 接入你的 AI 编码工具Claude Code 用一条软链接命令即可启用ChatGPT 等其他 Agent 则通过上传或指向SKILL.md文件接入。前提是你已经安装了 Quarkdown CLI即quarkdown命令可用因为 skill 的位置需要通过 CLI 的doctor get命令解析。先确认 skill 的安装位置skill 随 Quarkdown 一起分发quarkdown doctor get agent-skill会打印它的绝对路径。这个get子命令的输出是一行一个值专门用于 shell 替换见 CLI - Doctor。运行quarkdown doctor get agent-skill命令输出了形如绝对路径的一行内容说明 CLI 正常工作后续步骤都可以依赖它。该目录下包含一个SKILL.md入口文件AI Agent 工具可以读取或软链接它。在仓库中可以直接对照 skills/quarkdown/SKILL.md 查看这个入口文件的实际内容。在 Claude Code 中启用把打包好的 skill 目录软链接到 Claude 的 skills 目录ln -s $(quarkdown doctor get agent-skill) ~/.claude/skills/quarkdown这条命令用ln -s在~/.claude/skills/下创建一个名为quarkdown的符号链接指向quarkdown doctor get agent-skill解析出的目录它只在你的用户目录新增一个链接不修改 Quarkdown 安装内容。链接创建后重启 Claude 会话让 skill 被加载。验证 skill 是否生效skill 的激活条件是你让 Claude 去写或编辑一个.qd文件。给 Claude 一个明确的任务例如把这个 Markdown 改写成.qd文档skill 应自动接管。如果 skill 没有自动触发可以手动调用/quarkdown来触发它。在 ChatGPT 与其他 Agent 中启用对 Claude Code 之外的 Agent接入方式是上传SKILL.md文件或让 Agent 直接指向该文件。先用下面的命令拿到它的完整路径echo $(quarkdown doctor get agent-skill)/SKILL.md然后把输出的这个文件上传给你的 Agent或让它读取该路径。SKILL.md带有 frontmattername: quarkdown描述中写明了适用场景编写或编辑.qd文件、生成 HTML/PDF/纯文本等排版输出。文件中还包含使用边界当最终目标就是纯 Markdown聊天、README、GitHub issue时不应使用这个 skill。skill 驱动 Agent 的实际工作流程启用后Agent 并不是自由发挥而是按 SKILL.md 中定义的流程工作。理解这个流程有助于你核对 Agent 的行为是否符合预期定位安装目录。Agent 应运行一次QUARKDOWN_INSTALL$(quarkdown doctor get install-dir)quarkdown doctor get install-dir打印包含bin/、lib/、docs/的发行版根目录见 CLI - Doctor。阅读内置文档。安装目录下的docs/wiki/_nav.qd是 wiki 索引docs/wiki/quickstart.qd是新用户的入口需要精确的函数签名时查docs/quarkdown-stdlib/下的 stdlib API 参考HTML 格式。skill 要求 Agent 在写非平凡内容前先读相关 wiki 页。新建项目。如果用户想从零开始一个 Quarkdown 项目skill 要求 Agent 让用户自己运行quarkdown create [dir]交互式向导而不是手工搭建项目文件。写文件并编译验证。Agent 写完.qd文件后要执行quarkdown c main.qd --strict --out /tmp/quarkdown-verify其中main通常是main.qd但 Agent 应结合你的项目确认。--strict让编译器在出错时退出非严格模式下错误只是以框的形式显示在文档里--out /tmp/quarkdown-verify把产物写到临时目录避免污染你的项目默认输出目录是 CWD 下的./quarkdown-output。这些参数均可在 CLI - Options 中查到。报告编译错误。skill 的最后一步是把编译报错原样反馈给你。两条 skill 明确禁止的行为值得留意--pdf会启动无头浏览器、速度较慢只在用户明确要 PDF 时使用live preview-p、-w是长驻 web serverAgent 只应把命令建议给你而不是自己运行选项含义见 CLI - Options。常见问题与限制skill 没有自动激活用/quarkdown手动触发确认软链接存在且目标目录非空quarkdown doctor get agent-skill应能输出路径。quarkdown doctor get agent-skill无输出或命令不存在说明 Quarkdown CLI 本身不可用需要先完成 CLI 安装本 skill 的所有步骤都依赖quarkdown命令在 PATH 中。适用边界该 skill 面向.qd文档的编写与编辑。若你的产出物只是纯 Markdownskill 自身声明此时不应使用。skill 的完整说明见 Use with AI agents。启用完成后日常用法就是直接向 Agent 提写/改一个.qd文件类的需求并核对它是否走了读内置文档 → 写文件 →--strict编译验证 → 报错反馈这条链路。【免费下载链接】quarkdown Markdown with superpowers: from ideas to papers, presentations, websites, books, and knowledge bases.项目地址: https://gitcode.com/GitHub_Trending/qu/quarkdown创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考