菜单
框架反馈打包 — 把下游项目使用 CataForge 时发现的问题 / 改进建议 / 偏离上游基线的纠偏，打包成 upstream-ready 的 markdown bundle，回流到 CataForge 仓库。区别于下游项目自身的用户反馈渠道：本 skill 仅针对 CataForge 框架本体（CLI / scaffold / agents / skills / hooks / docs）。当用户提到反馈框架问题、提交 CataForge issue、上游 baseline 不准确、累积 upstream-gap 想批量回报时使用。
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
基于 SOC 职业分类
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/lync-cyber/CataForge --skill framework-feedback命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
CataForge 框架同步 — 把已安装包、.cataforge/ scaffold、IDE 产物、项目初始化四层对齐到当前已验证状态。幂等、升级感知：检测包↔scaffold 版本差异，升级包并刷新 scaffold，部署 IDE 产物，运行 doctor 验证，按版本迁移要点提示升级重点与迁移动作；项目未初始化时进入 Project Bootstrap，已初始化时装配执行环境并交接 start-orchestrator。当用户提到 CataForge 升级、scaffold 过期、框架版本不一致、bootstrap 或刷新项目脚手架、初始化/恢复项目时，使用此 skill。
部署配置 — CI/CD流水线、容器化、环境配置、基础设施即代码。当需要配置 CI/CD 流水线、编写 Dockerfile/compose、管理多环境配置或基础设施即代码时使用此 skill。库/SDK 项目可标 deployment N/A 跳过。
测试 — 测试策略规划、测试编写与执行、覆盖率分析、缺陷记录。当需要规划测试策略、编写或执行测试套件、分析覆盖率或记录缺陷时使用。本 skill 不改源码（缺陷修复由 debug 负责），单任务 RED/GREEN 单元测试由 tdd-engine 负责，testing 聚焦集成/E2E 与覆盖盲区补充。
| 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 |
cataforge --version + doctor + 最近 N 条 EVENT-LOG + CORRECTIONS-LOG deviation=upstream-gap + framework-review Layer 1 FAIL 摘要；渲染为 markdown；脱敏路径；通过 --print / --out / --clip / --gh 四选一发出--gh，且需本机已装并登录 gh）bug | suggest | correction-export.cataforge/ + docs/EVENT-LOG.jsonl + docs/reviews/CORRECTIONS-LOG.md（任一缺失都降级为部分 bundle，不阻断）cataforge.core.feedback（assembler；CLI 与本 skill 共用同一份逻辑）--out PATH: 写到指定文件（相对路径解析在项目根下）.github/ISSUE_TEMPLATE/feedback-from-cli.yml（字段与本 bundle 一一对应，方便上游分诊）state_change 事件（record-to-event-log: true），ref=skill:framework-feedback/framework_feedbackframework-feedback 是按需触发的反馈打包 skill，不进入业务流程主循环。推荐的合规触发面：
cataforge feedback bug --gh（或 suggest / correction-export）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 持有）。落盘后由用户决定是否上报cataforge feedback bug --print | tee docs/feedback/doctor-fail-<ts>.mdbugsuggestdeviation=upstream-gapcorrection-export调用约定（单一入口）: 一律通过 cataforge skill run framework-feedback -- <kind> [--summary ...] 触发，由框架解析 SKILL.md 元数据并派发到 builtin 脚本。不得直接 python .cataforge/skills/.../scripts/*.py——该路径为框架内部实现细节，不保证存在。
执行示例:
# bug 反馈到 stdout
cataforge skill run framework-feedback -- bug --summary "deploy 后 hook 不触发"
# 建议写盘等待复核
cataforge skill run framework-feedback -- suggest \
--summary "希望支持 --dry-run 预览" \
--out docs/feedback/suggest-$(date +%Y%m%d).md
# 上游反馈聚合 (仅当 upstream-gap 数 ≥ threshold；缺省 threshold = RETRO_TRIGGER_UPSTREAM_GAP_DEFAULT)
cataforge skill run framework-feedback -- correction-export
推荐使用 CLI 同等命令直接触发上游通道（skill 仅产 markdown，不直接发 issue）:
cataforge feedback bug --gh # 通过 gh 直接开 issue
cataforge feedback bug --clip # 拷剪贴板，手动粘贴到 GitHub
cataforge feedback bug --out feedback.md # 落盘
--gh label 解析label 由 framework.json#feedback.gh.labels 配置（bug / suggest / correction-export 三键各映射到一组 label），不在代码里硬编码。fallback_on_missing_label: true（默认）让上游 label 缺失时自动丢掉 --label 重试并 stderr WARN；要给上游加自定义 label 先跑 cataforge feedback ensure-labels（需 push 权限）；空列表等价于不传 --label，由 issue 模板的 labels: 字段兜底。
<project> 与 ~ 路径替换占位符--include-paths权威清单见 cataforge.runtime.skill.builtins.framework_feedback.CHECKS_MANIFEST。
gh CLI 时强行 --gh —— 会直接 ExternalToolError；应回退 --clip 或 --print--include-paths 输出后直接贴公开 issue —— 会泄漏本机目录结构；公开前先脱敏或去掉路径upstream-gap 纠偏时跑 correction-export —— 该子命令会拒绝（exit 1）以防止空 bundle；应先积累纠偏记录framework.json#feedback.gh.labels 里写上游不存在的 label 而不先 cataforge feedback ensure-labels —— fallback 兜得住但 issue 缺分类标签，影响上游分诊