al-folio 引导 是做什么的?
当用户要求智能体创建、配置或个性化一个新的 al-folio v1.x 网站时,使用此技能。
工作流程
- 在编辑之前,先阅读
AGENTS.md和docs/BOUNDARIES.md。 - 保持启动包精简:首先自定义
_config.yml、_data、内容集合和站点资产。 - 将运行时行为保留在插件仓库中。除非用户有意进行本地覆盖,否则不要将插件拥有的布局、包含文件、Sass、JavaScript 或资产复制到启动包中。
- 对于本地视觉/内容自定义,优先使用:
_config.yml的功能标志和站点元数据_data/*.yml_pages、_posts、_projects、_news、_teachings、_bibliography- 只有当配置/内容无法表达更改时,才使用本地
_includes、_layouts和_sass覆盖
- 在交回工作前运行验证:
npm ci
npm run lint:prettier
bundle exec al-folio upgrade audit --no-fail
bundle exec jekyll build --baseurl /al-folio
路由
- 启动包的连线/文档/示例/测试:编辑
al-folio。 - 共享布局/包含文件/资产:使用
al_folio_core。 - CV 渲染:使用
al_folio_cv。 - Distill 运行时:使用
al_folio_distill。 - 搜索/图标/数学/评论/分析/引用/外部文章/通讯/图表/图片:使用对应的
al-*插件仓库。
移交
总结修改的文件、验证结果以及创建的任何本地覆盖。