sourcelin-cloud-blog AGENTS.md

AGENTS.md

本文件是 Sourcelin Cloud Blog 仓库级 AI 执行入口。所有 AI 编程工具进入本仓库后必须先读取本文件，再按任务读取对应 rules/ 和 skills/。

默认使用中文进行沟通、注释、提交说明和文档更新。所有文本文件保存为 UTF-8 无 BOM。

1. 项目范围

Sourcelin Blog 是基于 Sourcelin-Cloud v3.6.3 的微服务博客平台。

后端：

sourcelin-api/        # Feign 接口与跨服务 DTO

sourcelin-common/     # 公共能力，不放业务逻辑

sourcelin-gateway/    # 网关

sourcelin-auth/       # 认证中心

sourcelin-modules/    # 业务服务

  sourcelin-system/   # 系统管理

  sourcelin-blog/     # 博客业务

  sourcelin-file/     # 文件服务

  sourcelin-job/      # 定时任务

sourcelin-visual/     # 监控等可视化服务

前端：

sourcelin-ui/sourcelin-ui-platform/    # 博客前台，Vue3 + TypeScript + Naive UI 抽象层

sourcelin-ui/sourcelin-ui-uniapp/      # 移动端小程序，Uniapp + Vue3 + TypeScript

sourcelin-ui/sourcelin-ui-admin/       # 管理后台主线，Vue3 + TypeScript + Element Plus

sourcelin-ui/sourcelin-ui-admin-vue2/  # 旧版迁移对照，不承载新功能

2. 开源分支边界

• scripts/** 不进入开源分支提交。
• docs/** 可以进入开源分支，但 docs/internal/** 不提交。
• 规则、技能和执行入口必须避免引用开源分支未提交的本地维护脚本。
• 数据库初始化文档和 SQL 维护在 docs/sql/**。

3. 仓库发布模型

• origin/master：公开发布分支，只承载对外可见内容。
• develop：日常开发分支，承载功能开发、规则演进和阶段性整理。
• master：公开发布分支，对外只暴露稳定版本。
• 日常开发必须先进入 develop，完成验证后再整理到 master。
• 对外发布必须以 master 为唯一来源，最终推送到 origin/master。
• 发布前必须完成公开边界检查，确保内部脚本、过程文档和仅内部使用的资料不会进入公开分支。
• MUST NOT：跳过 develop 直接在 master 上做日常开发。
• MUST NOT：将 develop、内部脚本或过程性资料直接推送到公开仓库。

4. 默认规则

每次开发、重构、审查或测试必须读取：

• rules/README.md

• rules/api-contract.md

• rules/coding-conventions.md

• rules/testing-and-validation.md

按任务追加读取：

• 后端：rules/backend.md

• 博客前台：rules/frontend-platform.md，并联查 sourcelin-ui/sourcelin-ui-platform/AGENTS.md

• Uniapp 移动端：rules/frontend-uniapp.md，并联查 sourcelin-ui/sourcelin-ui-uniapp/AGENTS.md

• 管理后台：rules/frontend-admin.md

规则优先级：

1. 本文件

2. 更近目录的 AGENTS.md / rules/

3. rules/api-contract.md

4. 领域规则

5. rules/coding-conventions.md

6. rules/testing-and-validation.md

5. 可用技能

• skills/frontend-platform-dev/SKILL.md：博客前台开发。