feat(ext): 文档受众拆分(README/CHANGELOG)与确认流 ask_user 卡片化

[sundevilyang]

Mainline Intent

Intent: int_c7ac7eae
Status: proposed
Title: 确认流改走宿主 ask_user 点击卡片，替代文字确认

What changed

扩展 cgc-admin/cgc-assistant/cgc-tutor 三个 agent prompt 的确认流纪律改为：复述 summary 后调用宿主内置 ask_user 弹可点击卡片（选项 确认执行/取消，多 pending 每题一个 question），点击结果映射 confirm_operation/cancel_operation；admin-aside 面板注入指令同步。后端 response.ex hint 与 playbooks.ex 两个 playbook 的确认流纪律同步（需部署生效）。CONTEXT.md 术语 request_user_feedback→ask_user 并记录防线。

Why

gem 1.5.13 内置 ask_user 卡片（request_user_feedback 的继任），WebUI 可点击；扩展原确认流让用户打字回复「确定/确定全部」，体验差且已造成一次误触发事故，故接入点击卡片。

Decisions

• 确认交互形态: 复用宿主内置 ask_user 卡片，不在扩展面板重造确认 UI (ask_user 是 gem 内置原语、WebUI/UI2/终端/IM 全端降级就绪；面板保持纯读投影+意图注入边界)
  • Rejected: 在 admin-aside 面板自建确认按钮（injectIntoComposer）
• 批量 pending 的呈现: 一次 ask_user 调用、每个 pending 一个 question（分步卡片） (逐题确认比单选项「确认全部」更可审计，杜绝一次点击触发 N 个不可逆操作)
• 无人值守防线: ask_user 结果出现 auto_reply 一律 cancel_operation (auto_approve（定时任务）10s 倒计时自动决策是已知风险，确认流必须保守拒绝)
  • Rejected: 沿用自动决策
• 选项文案: 固定 「确认执行」/「取消」 (回传是纯文本，稳定文案让 agent 可靠识别选择)

Subsystems: openclacky-ext, mcp-confirmation-flow

---

Mainline Intent

Intent: int_39145fd0
Status: proposed
Title: 扩展文档受众拆分:README 用户向重写与安装口径修正

What changed

openclacky-ext/cgc-2046 文档按受众拆分(commit 615dfc1,4 文件):README.md 重写为面向用户的使用说明(功能一览/系统要求/安装/连接/断开卸载/隐私安全/FAQ);开发者内容(架构/目录结构/打包/联调/测试/验收)迁入新建 DEVELOPMENT.md;新增 CHANGELOG.md 全历史归并(v0.1.0 按功能域汇总 2026-08-09 起首发内容,其后提交归 Unreleased);.gitignore 增加 DEVELOPMENT.md 排除

Why

README 会进 ext pack 分发包,是用户安装扩展后可见的主文档,但原文 17KB 混入大量开发者细节;且「CGC OpenClacky 一键安装包捆绑扩展」说法与事实不符(用户纠正:品牌安装不带扩展),需对齐「OpenClacky 官方安装方式装宿主 + Extension Marketplace 装 cgc-2046」口径;扩展此前无 changelog 记录

Decisions

• README 中开发者内容(目录结构/打包脚本/测试命令/安全约定细节)如何处理: 迁入同目录 DEVELOPMENT.md,沿用 test/bin 既有模式:git 跟踪(repo 开发者可见)但经容器 .gitignore 排除出 ext pack 分发包 (信息无损,分发包只带面向用户的 README/CHANGELOG;经用户确认选择)
  • Rejected: 直接删除——丢失既有验收/联调文档
• CHANGELOG 覆盖范围(ext.yml 版本锚点 v0.1.0 于 2026-09-06 设定): 全历史归并:v0.1.0 条目按用户可感知功能域汇总 2026-08-09 起全部首发内容,之后的提交归 [Unreleased] (历史完整;纯内部重构(路由声明表/共享骨架/harness 迁移)按噪音过滤不录入)
  • Rejected: 仅从 v0.1.0 起记录,省略早期开发期提交
• 安装引导口径: 官方方式装宿主(openclacky.com 下载安装器/CLI) + 扩展市场搜索 CGC-2046 安装;README 安装节/升级 FAQ 与 DEVELOPMENT 生产安装段三处旧说法全部移除 (用户明确纠正:品牌一键安装不捆绑扩展;与同分支 60b21e3(web 接入引导升级为市场安装路径)同口径)
  • Rejected: 保留品牌一键安装链接说法——与事实不符

Subsystems: openclacky-ext/cgc-2046/docs