平台配置目录 · 说明与索引
本目录是 平台配置的说明与索引，不替代实际配置位置。 卡若AI 的
.gitea、.github、.cursor等平台约定目录 必须保持在仓库根目录，平台才能正确识别。
一、为何不能移动？
| 目录 | 平台 | 约定 | 移动后果 |
|---|---|---|---|
.gitea/ |
Gitea | 工单模板、合并请求模板 | 工单/PR 模板失效 |
.github/ |
GitHub | Actions 工作流 | 流水线不执行 |
.cursor/ |
Cursor IDE | 规则、配置 | 规则不加载 |
这些是平台级约定，路径固定，无法通过配置更改。
二、各目录实际位置与内容
2.1 .gitea（Gitea 约定，根目录）
| 文件/目录 | 用途 |
|---|---|
.gitea/ISSUE_TEMPLATE/ |
工单模板（默认、功能建议、Bug反馈、任务报备） |
.gitea/pull_request_template.md |
合并请求模板 |
维护说明：金仓/Gitea管理 Skill，01_卡资（金）/_团队成员/金仓/Gitea管理/SKILL.md
2.2 .github（GitHub 约定，根目录）
| 文件/目录 | 用途 |
|---|---|
.github/workflows/sync_github_to_gitea.yml |
GitHub → Gitea 同步流水线（定时/手动） |
维护说明：群晖NAS管理 scripts，01_卡资（金）/_团队成员/金仓/群晖NAS管理/scripts/sync_github_to_gitea.sh
2.3 .cursor（Cursor 约定，工作区根）
| 文件/目录 | 用途 |
|---|---|
.cursor/rules/karuo-ai.mdc |
卡若AI 唯一必需的 Cursor 规则 |
维护说明：本规则为每次对话强制加载，修改后需重启 Cursor 或重载窗口生效。
三、统一管理方式
虽然这些目录不能移动，但可以通过本目录实现统一理解与管理：
- 本 README：说明各目录位置、用途、维护归属
- 目录结构变更SOP：
运营中枢/references/目录结构变更SOP.md— 做目录重组时必读 - Skill 主索引：
运营中枢/skill_router/SKILL.md— 技能路径变更后需同步更新
四、禁止独立功能目录（强制）
不得新建 _共享模块 或任何与五行、运营中枢并列的「功能目录」。所有共享能力必须融入现有结构：
- 参考资料、复盘格式、流程说明 →
运营中枢/参考资料/ - 本地模型/记忆/任务路由等兼容层 →
运营中枢/下对应子目录（实际实现仍在 02/04 对应成员目录） - 脚本与代码 → 归属到
01_卡资（金）～05_卡土（土）对应成员下
根目录仅允许：.cursor、.gitea、.github、01_卡资（金）～05_卡土（土）、运营中枢、images、以及入口文件（BOOTSTRAP.md、SKILL_REGISTRY.md、总索引.md、README.md 等）。违反即视为结构违规。
五、新增平台配置时
若需新增（如 .pre-commit-config.yaml、.editorconfig 等）：
- 确认该平台是否要求根目录（多数工具要求根目录）
- 在本 README 的「二、各目录实际位置与内容」下追加说明
- 执行
运营中枢/参考资料/目录结构变更SOP.md中的检查清单（若存在）