Agent Skills 文档站如何本地运行并预览修改【免费下载链接】agentskillsSpecification and documentation for Agent Skills项目地址: https://gitcode.com/GitHub_Trending/ag/agentskills如果你打算修改 Agent Skills 的官方文档错字、表述、示例或新增指南页按 CONTRIBUTING.md 的贡献流程改动需要先通过本地预览确认再提交 PR。这个仓库的文档站基于 Mintlify 构建源文件都在docs/目录下。下面的步骤讲如何在本仓库里启动本地开发服务器在http://localhost:3000查看页面并验证你对 mdx 文件的修改。准备先把仓库克隆到本地。贡献流程是 fork 仓库、创建分支、提交 PR见 CONTRIBUTING.md 的 Submitting Changes所以建议先 fork 再克隆你自己的分支。环境里需要 npm/npx文档给出的启动命令都是 npm 命令。Mintlify CLI 本身不必预先全局安装用npx即可运行。站点的内容和导航都在docs/下docs.json是站点配置站点名、导航页、重定向等见 docs/docs.json正文页面是home.mdx、specification.mdx、clients.mdx以及skill-creation/、client-implementation/下的 mdx 文件。启动本地开发服务器文档给出了两种等价方式任选其一。方式一全局安装 Mintlify CLI 后运行 mint devCONTRIBUTING.md 的 Development Setup 一节# Install Mintlify CLI npm i -g mint # Run local dev server from the docs/ directory cd docs mint devnpm i -g会把 CLI 装到全局即向系统全局 node_modules 添加一个包。装好后每次只需执行第二步。方式二在 docs/ 目录下直接运行 npx mint devdocs/README.md 说明在docs.json所在的文档根目录执行cd docs npx mint dev这种方式不需要全局安装。另外根目录 package.json 定义了dev脚本内容就是cd docs npx mint dev所以在仓库根目录执行npm run dev也等价于方式二。预览并验证修改开发服务器启动后用浏览器打开http://localhost:3000——这是两处文档给出的本地预览地址。验证你的改动修改docs/下的页面文件。例如修正docs/skill-creation/best-practices.mdx的表述或调整docs/docs.json里的导航项。在浏览器中访问http://localhost:3000对应的页面确认修改已经体现。docs.json的 navigation 中列出的页面条目如skill-creation/quickstart对应docs/skill-creation/quickstart.mdx可按此关系找到要改的文件。提交与上线文档给出的完整流程CONTRIBUTING.md Submitting Changesfork 仓库为改动创建分支完成修改并在本地验证提交 PR保持 PR 聚焦于一个逻辑变更并关联相关 issue合并后推送到默认分支时变更会自动部署到线上——docs/README.md 写道Changes are deployed to production automatically after pushing to the default branch. 也就是说http://localhost:3000的本地预览就是你提交 PR 前能做的确认手段。另外一条硬性要求如果贡献过程中使用了任何形式的 AI 辅助必须在 PR 或 issue 中披露 AI 的参与程度例如主要由 Claude Code 编写或用 ChatGPT 了解代码库但解决方案由本人完成仅空格或错字的琐碎修改可豁免披露。【免费下载链接】agentskillsSpecification and documentation for Agent Skills项目地址: https://gitcode.com/GitHub_Trending/ag/agentskills创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考