该技能面向 Blume 文档站点的维护工作,而非内容创作。Blume 是基于 Astro/Vite 的 Markdown 优先文档框架,内容存放在内容根目录(默认 docs/)下的 Markdown/MDX,导航由文件树与可选 meta.ts 推导,blume build 校验 frontmatter 与重复路由,blume validate 检查链接与锚点。\n\n主要能力:依据审计清单核对回顾窗口内(默认最近 7 天)合并的 PR、变更日志、发布说明、配置 schema、导出 API、CLI 帮助与示例,与现有文档比对,定位命令、选项、默认值、路由、属性或工作流上的偏差。\n\n使用方式:先读取仓库的 AGENTS.md、CLAUDE.md 与贡献说明,定位 blume.config.ts 中的 content.root、页面目录与构建命令。若已有以 blume/ 开头的维护分支 PR,则更新该分支而非新建重复 PR;否则确认需要修改后从默认分支创建 blume/docs-refresh-YYYY-MM-DD。完成编辑后运行 blume build 与 blume validate,并按仓库惯例执行 lint/format/typecheck,仅提交维护性改动并推送分支,以 blume: refresh docs for YYYY-MM-DD 标题创建或更新 PR。若无可执行改动,应输出简短报告并不创建分支、提交或 PR。\n\n限制:只记录已发布行为,不得虚构功能、时间线、价格、API 或兼容性;受特性开关控制的内容除对目标受众启用或仓库明确说明外不写入文档。以事实为先,避免主观改写与纯格式变动,保持最小正确差异并沿用站点语气、frontmatter 风格、组件用法与 meta.ts 导航模式。命令、标志、配置键、环境变量、路由与版本号须从代码中逐字复制。遵守仓库约定,不触碰生成目录(.blume/、dist/),不覆盖无关本地改动。外部链接仅在已检查页面依赖它们时核对,优先官方来源。其他具体配置与平台信息暂未提供。
blume-update-docs
编程与开发
更新于 10-16 05:50