Precipitate generic Agent routing and how-to gold standards

references/ACTIONS.md

@@ -18,6 +18,23 @@
 
 禁止对长任务 `exec`/`bash` + `process poll` 干等 CLI。禁止 `uv run python` 跑技能脚本。
 
+## async 副作用 Action 最小组合（复制验收 checklist）
+
+对每个「会开浏览器 / 长耗时 / 需进度或取消」的 Action，声明时建议同时满足：
+
+1. `executionProfile: "async"`（进入任务中心）
+2. 若要让 Agent 触发：`placements` **含** `agent`
+3. 有可感知副作用时：提供 `confirmation.message`
+4. 需要用户/Agent 入参时：简单 `inputSchema` + entrypoint 中的 `{{fieldName}}`
+5. `SKILL.md`「用户意图路由表」与 `CLI.md`「Action 强制黑名单」**出现同一 action id / 命令**
+
+默认模板 `assets/actions.json` 仅含诊断类 sync Action，**不要**为通过本 checklist 而塞假业务 Action；业务技能按需添加。完整字段见下文 Phase 1。
+
+## 可选：域前缀 CLI（嵌套子命令）
+
+小技能可继续扁平：`entrypoint.command = "run"`。  
+命令变多时，可采用**域前缀**：`command` 为域（如 `<domain>`），业务动词与参数放在 `args` 数组（如 `["<verb>", "--flag", "{{field}}"]`）。与扁平入口等价，须仍指向同一 domain service。
+
 ## 模板严格规范 vs 宿主向后兼容
 
 | 角色 | 定位 |