SuperAPI AI 工具集

bagisto-documentation

写作与研究

查看项目

更新于 10-15 17:24

技能介绍

用途:该技能用于编写或更新 Bagisto 文档站点,包括开发者文档、商家用户指南及后续新增的指南,适用于所有 VitePress 构建的 Bagisto 文档仓库。

主要能力与规则:先确定读者对象——写代码的读者进开发者文档,只用管理后台运营店铺的读者进用户指南;一个页面若两者都需要,应拆成两页并互链。文档不放在 Bagisto 应用内,而是独立仓库,需先查找,不要臆造路径:find . ~ -maxdepth 6 -type d -path '*/src' -path 'doc' 2>/dev/null | head。 编写前要阅读同章节已有页面,匹配深度、标题节奏与语气,并检查重复内容。页面位于 src/ 下,侧边栏在 .vitepress/config.mts,旧 URL 在 .vitepress/_redirects.ts;预览用 npm run docs:dev,npm run docs:build 是准入门槛。文件名统一 kebab-case。

硬性要求:已发布 URL 不得失效,重命名、移动、改 slug、拆分或删除页面都需在 .vitepress/_redirects.ts 添加重定向并重指旧重定向;侧边栏是唯一导航,页面必须同步加入;先查实现再参考旧文档,所有命令、路径、类、方法、路由和标签都必须来自本次会话中读取的文件或运行的命令;PHP 代码示例需符合项目 pint.json(laravel preset)格式;顺序操作写成编号步骤;全套文档跨版本统一,当前版本称 Bagisto 2.5;AI 术语须由实现支撑,不夸大自主性。完成后独立审计,并用 bagisto-change-verification 验证。llms.txt 与 llms-full.txt 需手工维护。

适用场景:Bagisto 文档仓库的页面新增、修改、迁移与发布。限制:资料未提供该技能的独立安装命令、收费方式或适用平台信息。