Agent Skill 使用方式
Forge 项目通过项目级 Skill 目录统一管理 AI 编程助手的专用能力。你在使用 AI 编程时，需要了解 Skill 的目录结构和触发方式。
项目级 Skill 目录
.agents/skills/
├── forge-codegen-crud/SKILL.md # CRUD 代码生成
├── forge-business-flow-development/SKILL.md # 流程业务开发
└── ...（其他项目级 Skill）注意：目录名是复数 agents（.agents/skills/），不是 .agent/skills/。
常用 Skill
| Skill | 用途 | 触发场景 |
|---|---|---|
forge-codegen-crud | CRUD 代码生成与审查 | 新增增删改查模块 |
forge-business-flow-development | 流程业务开发与审查 | Flowable 流程开发 |
使用原则
触发即读取
当任务匹配某个 Skill 描述时，执行前必须完整读取对应 SKILL.md：
bash
# CRUD 生成 → 读 forge-codegen-crud
cat .agents/skills/forge-codegen-crud/SKILL.md
# 流程开发 → 读 forge-business-flow-development
cat .agents/skills/forge-business-flow-development/SKILL.md最小必要原则
只读取本轮任务需要的 Skill。多个 Skill 同时适用时按任务链路排序读取，避免无关上下文污染判断。
规范优先级
AGENTS.md > spec.md > .agents/skills/*/SKILL.md > code-copilot/rules/* > 其他参考文档Skill 与 AGENTS.md 冲突时，以 AGENTS.md 为准。
编码默认遵循
Forge 编码类任务默认遵循 AGENTS.md 第 5 章关键约定。需要更细规范时继续读取：
code-copilot/rules/coding-style.md— 编码规范速查forge-docs/development/conventions.md— 完整编码规范
不同 Agent 适配
| Agent | 适配方式 |
|---|---|
| OpenCode | 扫描 .agents/skills/*/SKILL.md |
| DeepSeek TUI | 扫描 .agents/skills/*/SKILL.md |
| 其他 Agent | 在适配层映射到 .agents/skills/ |
所有 Agent 统一使用 .agents/skills/ 作为 Forge 项目专用 Skill 来源，禁止在仓库内复制两套 Skill。
禁止事项
- 禁止使用
superpowers/目录承载 Forge 项目规范 - 禁止在仓库内复制两套 Skill
- 项目级专用能力统一沉淀到
.agents/skills/ - 全局个人能力才放到用户级技能目录