内容
# AI 工具
我作为 Java 开发人员使用 **AI 编程助手** 的个人笔记。
---
## 内容涵盖
- **运行时工作原理** — 代理循环、工具、上下文限制 — 使失败感觉可调试而不是神秘的。
- **项目级连接** — `AGENTS.md`、`SKILL.md`、斜杠命令、子代理 — 助手已经与我的架构和标准对齐。
- **Java / Spring / DevOps 现实** — 迁移、CI、Helm、K8s。
---
## 我优化的栈
| 层级 | 技术 |
|---------------|------------|
| 语言 | Java 21+（记录、密封类、虚拟线程） |
| 框架 | Spring Boot 3.5+，Spring Data JDBC |
| 构建 | Maven 3.9+ |
| CI/CD | GitLab CI |
| 容器编排 | Kubernetes + Helm |
| 数据库 | PostgreSQL，Oracle |
| 助手 | Cursor（+ CLI），OpenCode |
---
## 模板
`templates/` 目录中的即用文件：
| 文件 | 描述 |
|------|-------------|
| `AGENTS.md` | 项目上下文模板 |
| `SKILL.md` | 技能模板 |
| `context-map.md` | 上下文映射模板 |
| `team-onboarding.md` | 团队入职指南 |
| `command-cursor.md` | Cursor 斜杠命令模板 |
| `command-opencode.md` | OpenCode 命令模板 |
| `mcp-config-cursor.json` | Cursor 的 MCP 配置 |
| `mcp-config-opencode.json` | OpenCode 的 MCP 配置 |
| `liquibase-changelog.xml` | Liquibase变更日志模板 |
| `sample-project/` | 带有技能、命令和 AGENTS.md 的参考 Maven 项目 — [OpenCode 工作流](opencode-agent-patterns/README.md)的演示目标 |
`context-map.md` 和 `team-onboarding.md` 是规范模板；`sample-project/` 保留项目特定的覆盖（路径、技能列表）。
---
## OpenCode 代理模式
[`opencode-agent-patterns/`](opencode-agent-patterns/) — 使用 [OpenCode](https://opencode.ai) 进行**多代理编排**：并行分诊、重构管道、PR-ready CI 修复、防止灾难循环。
从 [opencode-agent-patterns/README.md](opencode-agent-patterns/README.md) 开始 — 概念、工作流演练（第 0-5 节）、提示和食谱都在一个文件中。
| 资源 | 描述 |
|----------|-------------|
| [README.md](opencode-agent-patterns/README.md) | 完整指南 — 主/子代理模型、执行内部、命令、技能、Java 示例 |
| [templates/](opencode-agent-patterns/templates/) | 复制粘贴 `/triage`、`/hotfix`、重构、PR 审查命令 |
| [playbooks/](opencode-agent-patterns/playbooks/) | 红色构建分诊、安全重构、PR 预审、事件热修复 |
| [tools/](opencode-agent-patterns/tools/) | OpenCode 秘籍、生态系统链接、示例 `opencode.json` 代理 |
在 [`templates/sample-project/`](templates/sample-project/) 上练习 — 包括一个有意的失败测试用于分诊练习。
补充 [12-agents-subagents.md](12-agents-subagents.md)（代理无关概念）以实现 OpenCode 特定工作流。
---
## 章节
### 基础
| # | 文件 | 主题 |
|---|------|-------|
| 01 | [01-setup.md](01-setup.md) | 环境设置 |
| 02 | [02-how-ai-assistants-work.md](02-how-ai-assistants-work.md) | AI 助手的工作原理 |
### 提示
| # | 文件 | 主题 |
|---|------|-------|
| 03 | [03-prompting.md](03-prompting.md) | 提示基础和管理 |
| 04 | [04-prompt-techniques.md](04-prompt-techniques.md) | 提示技巧和最佳实践 |
| 05 | [05-llm-models.md](05-llm-models.md) | LLM 思考和模型选择 |
| 06 | [06-context.md](06-context.md) | 上下文策略和工程 |
| 07 | [07-prompt-optimization.md](07-prompt-optimization.md) | 提示优化 |
| 08 | [08-prompt-examples.md](08-prompt-examples.md) | 复制粘贴 Java/Spring 提示示例 |
### 配置
| # | 文件 | 主题 |
|---|------|-------|
| 09 | [09-agents-md.md](09-agents-md.md) | AGENTS.md |
| 10 | [10-skills.md](10-skills.md) | 技能 |
| 11 | [11-custom-commands.md](11-custom-commands.md) | 自定义命令 |
| 12 | [12-agents-subagents.md](12-agents-subagents.md) | 代理和子代理 — 另见 [opencode-agent-patterns/README.md](opencode-agent-patterns/README.md) |
| 13 | [13-agent-sessions.md](13-agent-sessions.md) | 代理会话 — 生命周期、子会话、压缩、跨会话交接 |
| 14 | [14-mcp-servers.md](14-mcp-servers.md) | MCP 架构、工具解析、配置 |
### Java 和 DevOps
| # | 文件 | 主题 |
|---|------|-------|
| 15 | [15-java-production-stack.md](15-java-production-stack.md) | Java / Spring Boot、数据库和 DevOps |
### 高级
| # | 文件 | 主题 |
|---|------|-------|
| 16 | [16-team-collaboration.md](16-team-collaboration.md) | 团队协作 |
| 17 | [17-security-and-privacy.md](17-security-and-privacy.md) | 安全和隐私 |
