AI copilots reference undefined tools, skills and knowledge indexes

[yinlianghui]

• The repo contains no *.tool.ts files and no defineTool calls, but skills list 11 custom tools: triage_case, search_knowledge, generate_email_copy, optimize_subject_line, personalize_content, generate_email, analyze_lead, suggest_next_action, analyze_pipeline, identify_at_risk, forecast_revenue. Only the 5 platform built-ins in live-data.skill.ts:41-47 resolve. Both agents' prompts orchestrate steps around these tools ("1. Call triage_case…").
• case-triage.skill.ts:16 instructs handing off to a response_drafting skill; no such skill exists (the service copilot mounts email_drafting).
• customer-360.skill.ts promises account + cases + opportunities + knowledge aggregation, but its only listed tool is search_knowledge.
• sales-copilot.agent.ts:37-40 (indexes: ['sales_knowledge'], topics sales_playbook/product_catalog/lead_qualification) and service-copilot.agent.ts:25-28 (indexes: ['support_knowledge']) reference knowledge indexes/topics defined nowhere in the repo.
• Both agents pin { provider: 'openai', model: 'gpt-4' } with maxTokens: 2000; the sales copilot's prompt requires describe_object on every turn across 15 objects.
• email-drafting.skill.ts:19 lists both generate_email_copy and generate_email; the latter never appears in its instructions.
• Skill permission strings (crm:case:write, crm:email:write, …) use a namespace that appears nowhere in profiles; crm_email is not an object in the stack.

[yinlianghui]

🎯 范围更新（2026-07-30）：agent 部分已失效，只剩 skills 引用不存在的工具

本 issue 正文写于两个 copilot agent 尚存时。那两个 agent 已由 #512 裁撤（src/agents/ 目录已不存在，AI 面改为 skills-only），所以正文中一切关于 agent 的描述、以及"两个 agent 都引用…"的表述不再适用。

在 main 上仍然成立的部分

src/skills/*.skill.ts 仍在 tools: [...] 里引用工具名，而仓库中没有任何 *.tool.ts 文件，也没有任何 defineTool 调用。已核实当前 main 上各 skill 声明的工具：

describe_object, get_record          ← 平台内置，可解析
query_records, aggregate_data        ← 平台内置，可解析
visualize_data                       ← 平台内置，可解析
search_knowledge                     ← ❌ 无定义，解析不到

即：正文列举的 11 个自定义工具里，绝大多数已随 agent 一起消失，当前仅 search_knowledge 仍被引用且无定义（在 src/skills/case-triage.skill.ts 等处，请以实际 grep 为准）。

建议修法（二选一，请在 PR 里说明理由）

1. 实现它 —— 若知识库检索确实要提供给 skill，新增对应工具定义；
2. 移除引用 —— 若不打算实现，从 skill 的 tools 列表里删掉，避免声明一个永远解析不到的能力。

无论哪种，建议补一条守卫测试：每个 skill 声明的工具必须能解析到平台内置或仓库内定义。请把新测试放在独立的新文件（例如 test/skills-integrity.test.ts），不要追加到 test/metadata-references.test.ts —— 那个文件是当前多个并行改动的冲突热点。

完成后

本 issue 可以关闭。