Skip to content

Commit 4366983

Browse files
committed
docs: v0.2.2 收尾 - README 路线图 + 启动模式表 + ADR 索引补完
README: - 路线图新增 v0.2.2 节点 (MCP v3 + 1h cache + agentic-runner) - 新增"启动模式"小节,对比 mcp_server vs agentic_runner - 文档目录把 ADR 计数从 7 改为 10 - 下一步候选加 "agentic-runner subagent 支持" docs/adr/README.md: - 按 phase 重新分组 (Phase 1-5 / v0.2.1 / v0.2.2) - 把 008/009/010 链接补上
1 parent 841b92d commit 4366983

2 files changed

Lines changed: 23 additions & 2 deletions

File tree

README.md

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -176,7 +176,7 @@ PYTHONPATH=src python -m dbjavagenix.cli server
176176
| [docs/screenshots/README.md](docs/screenshots/README.md) | MCP Apps 4 组件客户端兼容性 |
177177
| [docs/algorithms-overview.md](docs/algorithms-overview.md) | v0.2.1 schema 图算法 (topo / cluster / cycle) |
178178
| [docs/design-patterns-catalog.md](docs/design-patterns-catalog.md) | 生成器与生成代码中的设计模式 |
179-
| [docs/adr/](docs/adr/) | 7 个 ADR (架构 / 原子 / 渐进 / 规则 / 不引依赖 / schema 算法 / 规范配置) |
179+
| [docs/adr/](docs/adr/) | 10 个 ADR (架构 / 原子 / 渐进 / 规则 / 不引依赖 / schema 算法 / 规范配置 / MCP v3 / 1h 缓存 / agentic) |
180180
| [.claude/skills/java-codegen-from-db/SKILL.md](.claude/skills/java-codegen-from-db/SKILL.md) | 主 Skill: 代码生成 5 阶段工作流 |
181181
| [.claude/skills/springboot-migration/SKILL.md](.claude/skills/springboot-migration/SKILL.md) | 第二 Skill: Spring Boot 2.7→3.x 迁移 |
182182

@@ -189,12 +189,23 @@ PYTHONPATH=src python -m dbjavagenix.cli server
189189
- [x] **Phase 5**: 可观测性 + 生产就绪
190190
- [x] **Phase 6**: 文档与演示
191191
- [x] **v0.2.1**: Java 工程补完 (schema 算法 3 个 / 工程规范配置生成器 / 设计模式 catalog)
192+
- [x] **v0.2.2**: MCP v3 + AI 工程化 (elicitation 表单 / sampling 借 LLM / 1h prompt caching / agentic-runner)
192193

193194
下一步 (v0.3 候选):
194195
- DB 后端扩展: PostgreSQL / Oracle 完整支持
195196
- 抓取 Claude Desktop / Cursor 截图入仓 (P3.5 收尾)
196197
- 集成测试: 用 Testcontainers 把 MySQL 拉起跑端到端
197198
- 性能: 把规则推断与 LLM 路径合并为同一返回 schema (current LLM 路径输出格式与规则略不同)
199+
- agentic-runner 加 subagent 支持 (Agent SDK 已就绪)
200+
201+
## 启动模式
202+
203+
| 模式 | 入口 | 触发 | 依赖 | 适用场景 |
204+
|------|------|------|------|---------|
205+
| MCP server | `dbjavagenix server` | 客户端连接 (Claude Desktop / Cursor 等) | 无额外 | 探索 / 多轮交互 / 默认 |
206+
| Agentic runner | `server.agentic_runner.run_agentic()` | CLI 单次启动 | `claude-agent-sdk` + `ANTHROPIC_API_KEY` | 批处理 / CI / 一次性任务 |
207+
208+
两种模式共用同一 `database.mcp_tools` 注册表 (ADR-010)。
198209

199210
## 调试技巧
200211

docs/adr/README.md

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,21 @@
11
# Architecture Decision Records (ADR)
22

3-
> Phase 1-5 重构期间的关键决策。每个 ADR 包含: 背景 / 决定 / 替代方案 / 后果。
3+
> 重构期间的关键决策。每个 ADR 包含: 背景 / 决定 / 替代方案 / 后果。
44
55
## 索引
66

7+
### Phase 1-5 (v0.2 主线)
78
- [ADR-001: 三层架构 (Skills + MCP + Apps)](001-three-layer-architecture.md)
89
- [ADR-002: 拆分大工具为原子工具](002-atomic-codegen-tools.md)
910
- [ADR-003: Progressive Discovery (Tool Search)](003-progressive-tool-discovery.md)
1011
- [ADR-004: 规则推断优先于 LLM](004-rule-first-then-llm.md)
1112
- [ADR-005: 不引入的依赖 (划清边界)](005-non-dependencies.md)
13+
14+
### v0.2.1 (Java 工程补完)
15+
- [ADR-006: schema 图算法自实现](006-schema-algorithms.md)
16+
- [ADR-007: 自带工程规范配置生成](007-quality-config-generation.md)
17+
18+
### v0.2.2 (MCP v3 + AI 工程化)
19+
- [ADR-008: 引入 MCP v3 elicitation + sampling](008-mcp-v3-elicitation-sampling.md)
20+
- [ADR-009: 1h prompt caching TTL 作为可选项](009-prompt-caching-1h-ttl.md)
21+
- [ADR-010: agentic-runner 作为可选启动模式](010-agentic-runner-mode.md)

0 commit comments

Comments
 (0)