活动开发规范:给 AI 开发活动查阅的一份现状如实、差距列账的规范

用户要开始实现活动和工具调用逻辑,先把「活动怎么开发」写死成 docs/活动开发规范.md。
四条产品语义(本轮问答确认):
  ① 活动只读世界,一切写(台账/发邮件)必须经人类验收才落地;
  ② 活动间数据无强制类型,活动有启动 Schema —— 机械检查为门(required 缺项发补全卡)
    + Agent 案内随时可补;
  ③ 工具调用完全声明式 —— 未注册转人类执行卡+作业指导书(指导段写在工具声明里),
    未授权报错不转人;
  ④ 评价卡暂不做。
另补:工作台视图逻辑以 PRD 目录为语义权威(统一建模:AI Loop 自主、阶段可重复、
过程成果逐个验收;工作事项两类执行/验收、决策在对话区、三类同级唤醒事件、气泡二元制)。

写法纪律:**现状与目标分开说** —— 已就位的机制带 file:line(三路并行探查 + 关键行
逐条回源复核),产品要求但代码未到的标 ⚠️ 并汇总第 12 章待实现清单(11 条主账)。

**编排层确认满足**语义②:起单宽进、flatScope 零类型铺平、节点入参全铺下游自取、
出口载荷从落地事实推导、闭合只查结构+装载 —— 各有代码与测试证据,已写进第 5 章。

探查顺带钉出的两条要账(debt.md 已记,指向规范第 12 章):
  · 写类动作意向登记后**永不执行**(submitForRelease 无调用方,意向永停 drafted);
  · 工具未命中现状是抛错+拒装,转人链路整条待建。

本轮只出文档,不改一行代码。五闸绿(纯文档,跑闸当回归保险)。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KeDBx2PHLavbURXB8LJJ7m

docs/debt.md

@@ -203,3 +203,17 @@ intel-archive)只有契约面,入口产物是抛「未实现」的占位 ——
 
 顺带作废的旧欠账:「占位期六个槽位一律 flow 范式,真开发时装回 loop」——
 已经没有 flow 可退回,这条不存在了。
+
+## 活动与工具调用:实现前探明的账(2026-07-30)
+
+写《docs/活动开发规范.md》时三路探查把现状钉死,发现的差距与断链**全部汇总在
+规范第 12 章「待实现清单」**(11 条主账 + 一串小不一致),此处不重复,只记两条
+必须先修的:
+
+- **写类动作意向登记后永不执行**:`submitForRelease`/`precheck` 无调用方,活路径
+  绕过预检 → 意向永停 `drafted`,而 `land()` 只执行 `prechecked`。「所有写动作必须
+  经人类验收」目前只做到了「登记」,没做到「验收后执行」。
+- **工具未命中转人**:产品定「声明了但系统没有的工具,调用时转人类执行卡 + 作业
+  指导书」;现状是运行时抛 `ToolNotFoundError`、安装时 `tool-contract-missing` 直接拒装。
+
+实现活动与工具调用逻辑时,照规范第 12 章的顺序销账。