blutui-project-guidelines

Blutui 项目指南

加载与任务相匹配的规则文件。始终加载所有适用规则——多项规则经常相互重叠。

规则索引

任务	加载
创建／编辑任何模板、布局或组件	rules/foundation-templates-and-layouts.md
编写 Canvas 模板语法（标签、筛选器、函数）	rules/templating-canvas.md
包含／嵌入其他模板	rules/templating-including-templates.md
使用 Collections（查询、显示数据）	rules/collections.md
构建博客列表或文章页面	rules/blog.md
构建或处理表单	rules/forms.md
构建网站导航（页眉、页脚、下拉菜单）	rules/menus.md
设置路由或 URL 模式	rules/route-patterns.md
配置 Courier	rules/courier.md、rules/foundation-courier-configuration.md
项目文件结构／启动新项目	rules/foundation-file-structure.md
版本控制／切换磁带	rules/cassettes.md
调用 Blutui MCP 或编写 MCP 集成	rules/mcp.md
使用 Canopy Blocks（页面内编辑器）	rules/canopy.md + blutui-canopy-blocks 技能

规则文件位于：rules/<rule-name>.md

核心规则（始终适用）

1. 模板是 HTML 外壳；布局是编辑者可选的页面类型。 模板（views/templates/）定义包裹每个页面的外部结构——由开发者负责，编辑者不会修改。布局（views/layouts/）扩展模板，并表示编辑者在创建页面时从控制面板中选择的单个页面设计。请参阅 rules/foundation-templates-and-layouts.md。
2. 所有模板逻辑都使用 Canvas。 请参阅 rules/templating-canvas.md。
3. 将结构化内容存储在 Collections 中，而不是硬编码到模板中。 请参阅 rules/collections.md。
4. 不要编写原始 HTML 表单——请使用 Blutui 的表单标签。请参阅 rules/forms.md。
5. 不要自行创建新的顶层目录。 请参阅 rules/foundation-file-structure.md。
6. 先搜索文档。 在修改代码之前，通过 Blutui MCP 使用 search_blutui_documentation。请参阅 rules/mcp.md。

完整参考

所有规则的汇总文档：AGENTS.md

需要全面参考或不确定适用哪些规则时，请使用 AGENTS.md。