# OPENCODE.md

> 本文件供 opencode 在当前业务项目中读取项目 AI 规则。
> 通用编码规则只维护在 `AI_CODING_RULES.md`，本文件不复制规则正文。

## 必读入口

开始任何工作前，先阅读：

- `AI_CODING_RULES.md`
- `.ai/ARCHSIGHT_AIOS_RULES.md`
- `.ai/project-context.md`
- `.ai/agent-routing.md`
- `.ai/skills.md`
- `.ai/workflows.md`
- `.ai/profile-detection.md`
- `.ai/profiles/*.md`（如当前项目自动识别或显式启用了 profile）
- 项目自身的 `README.md`、`Makefile`、`scripts/` 或其他工程入口。

## opencode 入口适配

- 本文件只负责让 opencode 发现当前项目的公共规则和 `.ai/` 目录。
- ArchSight AIOS 只在 Agent 路由、Skill 选择、Workflow、交付验证、AI Runtime、Code Review，以及 AIOS 自动识别或用户明确启用的 BIM / IFC / 建筑行业 profile 等相关任务中作为补充治理层生效；普通非建筑任务不强制使用 `aios-*` Skill。
- 接入本模板不代表当前项目属于 ArchSightLabs，也不要求使用 Hermes、飞书或其他特定运行平台。
- 任务适合 ArchSight 技能包时，按 `.ai/skills.md` 选择对应 `aios-*` Skill；涉及流程协作时，按 `.ai/workflows.md` 选择 Workflow。
- 执行终端命令时，优先使用项目根目录的 `Makefile` 或 `scripts/` 中的辅助脚本（如存在）。