framework-feedback

name	framework-feedback
description	框架反馈打包 — 把下游项目使用 CataForge 时发现的问题 / 改进建议 / 偏离上游基线的纠偏，打包成 upstream-ready 的 markdown bundle，回流到 CataForge 仓库。区别于下游项目自身的用户反馈渠道：本 skill 仅针对 CataForge 框架本体（CLI / scaffold / agents / skills / hooks / docs）。当用户提到反馈框架问题、提交 CataForge issue、上游 baseline 不准确、累积 upstream-gap 想批量回报时使用。
argument-hint	<kind: bug|suggest|correction-export> [--print | --out PATH | --clip | --gh] [--summary TEXT] [--since YYYY-MM-DD] [--threshold N]
suggested-tools	file_read, shell_exec
depends	[]
disable-model-invocation	false
user-invocable	true
record-to-event-log	true

框架反馈打包 (framework-feedback)

能力边界

• 能做: 聚合 cataforge --version + doctor + 最近 N 条 EVENT-LOG + CORRECTIONS-LOG deviation=upstream-gap + framework-review Layer 1 FAIL 摘要；渲染为 markdown；脱敏路径；通过 --print / --out / --clip / --gh 四选一发出
• 不做: 修复发现的问题（仅打包反馈）；处理下游项目自身的产品反馈（与本 skill 无关）；自动发起 GitHub issue（除非显式 --gh，且需本机已装并登录 gh）

输入规范

• kind: bug | suggest | correction-export
• 项目根下的 .cataforge/ + docs/EVENT-LOG.jsonl + docs/reviews/CORRECTIONS-LOG.md（任一缺失都降级为部分 bundle，不阻断）
• cataforge.core.feedback（assembler；CLI 与本 skill 共用同一份逻辑）

输出规范

• 默认: stdout 渲染 markdown body
• --out PATH: 写到指定文件（相对路径解析在项目根下）
• 上游 issue 模板: .github/ISSUE_TEMPLATE/feedback-from-cli.yml（字段与本 bundle 一一对应，方便上游分诊）
• EVENT-LOG: 每次运行写一条 state_change 事件（record-to-event-log: true），ref=skill:framework-feedback/framework_feedback

推荐触发路径

framework-feedback 是按需触发的反馈打包 skill，不进入业务流程主循环。推荐的合规触发面：

• 用户手动: cataforge feedback bug --gh（或 suggest / correction-export）
• orchestrator 自动: 当累计 upstream-gap 数 ≥ RETRO_TRIGGER_UPSTREAM_GAP_DEFAULT 时，orchestrator 调起 cataforge skill run framework-feedback -- correction-export --out docs/feedback/<ts>.md（reflector 只读，本 skill 需要 shell_exec，故由 orchestrator 持有）。落盘后由用户决定是否上报
• doctor 报告 FAIL 后: cataforge feedback bug --print | tee docs/feedback/doctor-fail-<ts>.md
• 不要: 让 reviewer / implementer 在业务流程内自动调起（与业务 review 报告不是同一资源）

操作指令: 上游反馈打包 (feedback)

Step 1: 触发选择 kind

• 出现可复现 bug / 异常退出 / 部署后失败 → bug
• 框架行为符合预期但流程笨重 / 缺特性 → suggest
• 累计多条 纠偏 →