Monorepo 接入 · 每步改什么、怎么改

cd gov-agents-platform
uv sync --all-packages
uv run agentctl new agent release-notes-bot \
  --pattern supervisor \
  --specialists "diff_sp,changelog_sp" \
  --critic both

生成后应出现（builder.py 在包根，不在 nodes/）：

apps/release-notes-bot/
├── pyproject.toml
├── evals/golden.jsonl
├── tests/test_smoke.py
└── release_notes_bot/
    ├── builder.py
    ├── state.py
    ├── server.py
    ├── specialists.py   # 或 specialists/ 目录
    └── nodes/ …

① gov-agents-platform/pyproject.toml

在 [tool.uv.workspace] members 数组末尾加一行（若 agentctl 没自动加）：

"apps/release-notes-bot",

② gov-agents-platform/packages/gov-agents-server/src/gov_agents_server/main.py

在 AGENT_REGISTRY dict 里加：

"release-notes-bot": ("release_notes_bot.server", "build_router"),

在 AGENT_META dict 里加：

"release-notes-bot": {
    "title": "Release Notes Bot",
    "subtitle": "从 diff 生成发布说明",
    "prefix": "/agents/release-notes-bot",
},

③ apps/release-notes-bot/pyproject.toml

确认 BOM extras 符合 pattern，例如：

dependencies = [
    "ai-trust-toolkit-bom[core,supervisor]==0.6.0",
    ...
]
[tool.uv.sources]
ai-trust-toolkit-bom = { workspace = true }

改什么	文件路径	怎么改
Prompt	apps/.../release_notes_bot/prompts/*.md	写业务 prompt · 顶部第一行加关键词供 FakeLLM 匹配
Specialist 逻辑	apps/.../release_notes_bot/specialists.py 或 specialists/diff_sp.py	改 SP 函数体 · LLM 走 get_llm(tier="auto")
共享字段	apps/.../release_notes_bot/state.py	加 TypedDict 字段
串图	apps/.../release_notes_bot/builder.py	add_node / add_edge · 不在 nodes/ 下
单节点逻辑	apps/.../release_notes_bot/nodes/*.py	参考 Day 02 的 run_node 写法

详细 before/after 代码 → Day 02 步骤 4

apps/release-notes-bot/release_notes_bot/server.py

脚手架通常已生成 build_v1_router。你要改的是请求/响应映射三处：

1. MyAgentRequest — 定义 HTTP body 字段（例 target: str）
2. _initial_state(req) — 把 request 转成 graph 初始 state
3. _final_to_result(final) — 把 graph 输出转成 envelope.result 字段

示例（在现有 server.py 里找到对应函数改）：

class ReleaseNotesRequest(BaseModel):
    repo: str
    since_tag: str = "main"

def _initial_state(req: ReleaseNotesRequest) -> dict:
    return {"repo": req.repo, "since_tag": req.since_tag, "retry_count": 0}

def _final_to_result(final: dict) -> dict:
    return {
        "repo": final.get("repo", ""),
        "release_notes": final.get("output", ""),
        "critic_passed": bool(final.get("critique_passed", True)),
    }

❌ 不要新增 @router.post("/agents/.../run") 手写路由。

apps/release-notes-bot/evals/golden.jsonl

每行一条 JSON，至少 3 条（建议 20+）：

{"sample_id":"r-001","input":{"repo":"payment-svc","since_tag":"v1.0"},"ground_truth":{"has_notes":true},"tags":["smoke"]}

apps/release-notes-bot/tests/test_smoke.py

用 FakeLLM 测，不真调外网 LLM（模板通常已有，补断言即可）。

uv run pytest apps/release-notes-bot/tests/ -q

uv run uvicorn gov_agents_server.main:app --host 127.0.0.1 --port 8080

export PLATFORM_BASE_URL=http://127.0.0.1:8080
export AGENTCTL_USER_ID=dev
uv run agentctl invoke release-notes-bot --data='{"repo":"demo","since_tag":"main"}'