新闻详情

新闻详情

首页 / 资讯中心 / 详情

CCGS 结构化缺陷报告工作流:深入解析 `/bug-report` 技能的行为规范与测试体系

发布时间:2026/9/13 15:15:24来源:尧图网络
CCGS 结构化缺陷报告工作流:深入解析 `/bug-report` 技能的行为规范与测试体系
CCGS 结构化缺陷报告工作流深入解析/bug-report技能的行为规范与测试体系【免费下载链接】Claude-Code-Game-StudiosTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.项目地址: https://gitcode.com/GitHub_Trending/cl/Claude-Code-Game-Studios/bug-report是 Claude Code Game StudiosCCGS技能框架中用于把一段随意的用户描述转写为结构化缺陷Bug报告的实用型技能。本文以其行为测试规格bug-report.md为核心骨架逐层拆解它必须遵守的 7 个必填字段、追问补齐机制、查重与May I write协作协议、无导演门禁Director Gate的运维定位并结合仓库中的 catalog、质量评分卡与上下游技能/bug-triage、/hotfix源码说明该技能如何被自动化验证以及如何融入完整的缺陷生命周期。一、技能定位把口头描述变成可执行的缺陷单据1.1 它解决什么问题在 CCGS 中/bug-report属于utility类别下的运营型技能其核心职责只有一个接收用户的自然语言缺陷描述产出结构化的缺陷报告文档。它不负责修复缺陷也不负责优先级排序——这两件事分别由/hotfix和/bug-triage承接。从行为规格的 Skill Summary 看技能的输出是一份包含以下 7 个必填字段的报告序号必填字段含义1Title缺陷标题通常从用户描述中提炼2Repro Steps可复现该缺陷的具体操作步骤3Expected Behavior预期应当发生的行为4Actual Behavior实际发生的行为5Severity严重级别CRITICAL / HIGH / MEDIUM / LOW6Affected System(s)受影响的系统可多个用标签形式标记7Build/Version出现缺陷的构建或版本号如果用户最初的描述缺少上述任意一个字段技能不能直接开始写报告而必须通过追问follow-up questions补全缺口后再产出草稿。这一先补全、再成文的约束是整个技能行为规范的基石。1.2 输出位置与命名规范报告统一写入production/bugs/bug-[date]-[slug].md日期部分如2026-04-06slug由标题清洗sanitize而来例如标题 Game crashes when entering boss arena 对应文件名bug-2026-04-06-game-crashes-boss-arena.md在写入文件之前技能必须发起 May I write 询问并携带完整的文件路径例如 May I write toproduction/bugs/bug-2026-04-06-game-crashes-boss-arena.md?得到用户批准后才落盘。1.3 无导演门禁运营型技能的定位与设计、评审类技能不同/bug-report不使用任何 Director Gate。规格中明确写道None./bug-reportis an operational documentation skill. No director gates apply.也就是说缺陷报告是日常运营文档工作不需要 creative-director、technical-director 等导演 Agent 介入审批。这与 quality-rubric.md 中utility类别的定义一致——该类技能只需要通过 7 项静态检查如果某个 utility 技能确实会触发门禁则门禁的全/简/单人模式逻辑也必须正确但对/bug-report而言这一条不适用。二、静态断言技能结构可被自动校验/bug-report的行为规格第一部分是 Static Assertions (Structural)这部分由/skill-test static自动校验无需任何测试夹具fixture具备必要的 frontmatter 字段name、description、argument-hint、user-invocable、allowed-tools至少包含 2 个阶段phase标题包含结论关键词COMPLETE在写报告之前包含 May I write 协作协议用语结尾有下一步交接handoff例如指向/bug-triage重新排优先级或/hotfix处理 CRITICAL这套静态断言不是本技能独有而是整个测试框架的统一门槛。根据 README.md可以用以下命令对任意技能执行静态检查/skill-test static bug-report # 只检查 bug-report 一个技能 /skill-test static all # 检查全部 72 个技能只有当静态断言通过后才进入下一阶段的行为规格测试/skill-test spec bug-report。三、行为测试用例五个场景定义技能的正确行为规格的核心是 5 个测试用例每个用例包含Fixture前置状态、Input输入、Expected behavior预期行为、Assertions断言四要素。这些用例就是/bug-report技能的验收标准。3.1 Case 1Happy Path —— 崩溃类缺陷应判定为 CRITICAL前置状态production/bugs/目录存在且为空无相似历史报告。输入用户描述 Game crashes when player enters the boss arena。预期行为提取标题为 Game crashes when entering boss arena识别崩溃类报告应判定为CRITICAL严重级别与用户确认复现步骤、预期行为不应崩溃、实际行为崩溃、受影响系统arena/boss及构建版本起草完整的结构化报告询问 May I write toproduction/bugs/bug-2026-04-06-game-crashes-boss-arena.md?批准后写入文件结论为 COMPLETE。断言要点7 个必填字段全部在场崩溃报告严重级别为 CRITICAL文件名符合bug-[date]-[slug].md约定May I write 必须带完整路径结论为 COMPLETE。3.2 Case 2Minimal Input —— 信息缺失时逐个追问前置状态用户只提供 Sometimes the audio cuts out无任何历史报告。预期行为识别缺失字段复现步骤、预期 vs 实际行为、严重级别、受影响系统、构建版本针对每个缺失字段提出定向追问可逐条或结构化提示但至少 3 个追问用户逐项补充后技能才汇编出完整报告询问 May I write? 并在批准后写入。断言要点至少提出 3 个追问所有字段补齐前报告不得定稿缺失字段未补齐时禁止写文件全部补齐并写入后结论为 COMPLETE。这一用例直接对应 Skill Summary 中缺失字段先追问再起草的硬性约束杜绝了拿着半句话就写报告的偷懒行为。3.3 Case 3Possible Duplicate —— 查重优先链接而非新建前置状态production/bugs/bug-2026-03-20-audio-cut-out.md已存在标题相似、严重级别 MEDIUM。输入用户描述 Audio randomly stops working。预期行为扫描既有报告发现相似的音频缺陷明确告知用户A similar bug report exists: bug-2026-03-20-audio-cut-out.md给出两个选项作为重复链接在既有报告中补充交叉引用或仍然新建若用户选择链接需再次询问 May I update the existing report? 才能修改既有文件无论走哪条路径结论都是 COMPLETE。断言要点新建前必须先浮出相似报告用户有选择权不被强制链接或新建修改既有文件前必须再次 May I update 确认两条路径都以 COMPLETE 收尾。值得注意的是重复检测需要读取production/bugs/目录下已有的报告——这正是/bug-report与下游/bug-triage共享同一数据源的体现。3.4 Case 4Multi-System Bug —— 多系统影响合并在单份报告前置状态无既有报告。输入用户描述 After finishing a level, the save system freezes and the UI doesnt show the completion screen。预期行为从描述中识别出 2 个受影响系统Save System和UI报告在 Affected System(s) 下列出两个系统严重级别评估为HIGH存档冻结存在数据丢失风险询问 May I write 并写入。断言要点两个受影响系统都出现在报告中只创建一份报告而不是每个系统各建一份严重级别反映影响最大的组件存档冻结 → HIGH 或 CRITICAL结论 COMPLETE。3.5 Case 5Director Gate Check —— 确认无门禁、无导演 Agent前置状态任意缺陷描述。预期行为正常创建并写入缺陷报告不生成任何导演 Agent输出中不出现任何 gate ID无需门禁检查即达到 COMPLETE。断言要点不调用导演门禁不出现门禁跳过消息无门禁检查也能以 COMPLETE 结束。四、协议合规清单技能质量的第二道防线除了逐用例断言规格末尾还给出了 Protocol Compliance 清单等价于技能的通用行为底线起草报告前收集全部 7 个必填字段对任何缺失字段提出追问新建报告前检查是否存在相似既有报告写入前询问 May I write toproduction/bugs/bug-[date]-[slug].md?报告文件写入后结论为 COMPLETE这五项与 templates/skill-test-spec.md 模板中的协议合规部分一脉相承——所有技能规格都要求写入前先征求许可不以任何方式自动建文件/bug-report把这一通用协议落实到了查重 全路径 May I write的具体操作上。五、Coverage Notes已知未覆盖的边界情形规格最后的 Coverage Notes 诚实记录了未纳入自动化断言的三类边界情形这对评估技能鲁棒性很有价值严重级别与影响不匹配用户为崩溃类缺陷标注 LOW 级别时技能可以建议更高严重级别但最终尊重用户输入——此行为未纳入测试。Build/Version 为 unknown构建版本字段是必填但如果用户确实不知道unknown是被接受的合法值且不单独测试。slug 生成把标题清洗为文件名的实现细节不参与断言测试。这三条说明该技能的规格在设计上刻意留出了人机协商空间机器负责结构化与提醒最终决策权在用户。六、在缺陷生命周期中的位置与上下游技能的衔接/bug-report不是孤立存在的它处于 CCGS 缺陷处理链的入口位置6.1 上游输出 →/bug-triage排序与查重/bug-triage 读取production/bugs/下所有未关闭报告按 CRITICAL → HIGH → MEDIUM → LOW 排序输出分诊表。规格中/bug-report的静态断言要求结尾有下一步交接典型交接目标正是/bug-triage对缺少复现步骤的报告标记NEEDS REPRO INFO对标题 系统 严重级别相似的报告标记POSSIBLE DUPLICATE并互相交叉引用全程只读结论固定为 TRIAGED供 producer 或 QA lead 决策也就是说/bug-report负责创建结构化报告/bug-triage负责消费这些报告做优先级分诊二者共享production/bugs/这一数据契约。6.2 临界缺陷 →/hotfix紧急修复/hotfix 处理时间敏感的紧急修复从 main 创建 hotfix 分支、定位文件修改、跑/smoke-check验证、确认后合回 main。其手交接handoff反向指向/bug-report——修复完成后用/bug-report记录问题本身。这样一个 CRITICAL 缺陷的完整闭环是/bug-report记录结构化缺陷→ /bug-triage分诊排序→ /hotfix紧急修复 ↓ /smoke-check回归验证→ 合并 mainskill-flow-diagrams.md 的流程图中也明确绘制了/bug-report产出production/bugs/bug-NNN.md的流向印证了它在框架数据流中的固定位置。七、如何验证与改进该技能整个 CCGS Skill Testing Framework 的目的就是让技能自身可被测试、可被度量静态检查/skill-test static bug-report验证 frontmatter、阶段标题、COMPLETE 关键词、May I write 用语与交接段7 项检查。行为规格测试/skill-test spec bug-report按本文第三节的 5 个用例逐条评估。类别评分卡/skill-test category bug-report对照 quality-rubric.md 中utility类别的 U1通过全部 7 项静态检查、U2若触发门禁则模式逻辑正确指标。覆盖率审计/skill-test audit查看技能是否已有 spec、上次测试时间与结果。失败改进循环/skill-improve bug-report走测试 → 诊断 → 提出修复 → 重写 → 重测 → 保留或回滚闭环。catalog.yaml是整个测试体系的主注册表其中bug-report条目如下- name: bug-report spec: CCGS Skill Testing Framework/skills/utility/bug-report.md依据 CLAUDE.md 的说明规格文件描述的是当前行为而非理想行为可能编码了潜在缺陷当技能实际表现与规格不符时正确做法是先修正技能本身再同步更新规格——规格失败应被视作需要调查的信号而非技能必然出错的定论。八、结语/bug-report的规格文件完整定义了一个高质量缺陷报告技能应有的行为边界七字段全量收集、缺失即追问、查重优先、全路径 May I write、无导演门禁、以 COMPLETE 收尾。它通过 5 个行为用例 协议合规清单 覆盖说明形成闭环验证体系并与/bug-triage、/hotfix一起构成 CCGS 从发现问题到排定优先级再到紧急修复的完整缺陷处理流水线。对于希望在自己的 CCGS 项目中引入缺陷管理纪律的团队可以直接在production/bugs/下按bug-[date]-[slug].md约定积累报告用/bug-triage定期分诊、用/hotfix处理临界问题并通过 catalog.yaml 与/skill-test系列命令持续守护这套流程的质量。【免费下载链接】Claude-Code-Game-StudiosTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.项目地址: https://gitcode.com/GitHub_Trending/cl/Claude-Code-Game-Studios创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
网站建设高端定制企业官网
RELATED

相关资讯

更多精彩内容,欢迎继续阅读

较早相关资讯

最新相关资讯

Authelia `storage migrate` 命令详解:SQLite / MySQL / PostgreSQL 数据库 Schema 迁移管理指南 2026/9/13 15:45:27

Authelia `storage migrate` 命令详解:SQLite / MySQL / PostgreSQL 数据库 Schema 迁移管理指南

Authelia storage migrate 命令详解:SQLite / MySQL / PostgreSQL 数据库 Schema 迁移管理指南 【免费下载链接】authelia The Single Sign-On Multi-Factor portal for web apps. OpenID Certified™ and Post-Quantum Cryptography Ready. 项目地址: https://gi…

阅读更多 →
PostHog HogQL 解析器:基于 ANTLR 的语法生成流程与 C++/WASM 双端解析器构建管线 2026/9/13 15:45:27

PostHog HogQL 解析器:基于 ANTLR 的语法生成流程与 C++/WASM 双端解析器构建管线

PostHog HogQL 解析器:基于 ANTLR 的语法生成流程与 C/WASM 双端解析器构建管线 【免费下载链接】posthog :hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay,…

阅读更多 →
Teable Standalone 独立版 Docker 自托管部署指南:开箱即用的单机部署方案 2026/9/13 15:45:27

Teable Standalone 独立版 Docker 自托管部署指南:开箱即用的单机部署方案

Teable Standalone 独立版 Docker 自托管部署指南:开箱即用的单机部署方案 【免费下载链接】teable ✨ AI Spreadsheet for Business 项目地址: https://gitcode.com/GitHub_Trending/te/teable Teable 是一个构建在 PostgreSQL 之上的业务数据平台&#xff…

阅读更多 →
Backstage v1.35.0-next.1 变更深度解读:GitLab Catalog 提供者能力演进与升级实践 2026/9/13 15:45:27

Backstage v1.35.0-next.1 变更深度解读:GitLab Catalog 提供者能力演进与升级实践

Backstage v1.35.0-next.1 变更深度解读:GitLab Catalog 提供者能力演进与升级实践 【免费下载链接】backstage Backstage is an open framework for building developer portals 项目地址: https://gitcode.com/GitHub_Trending/ba/backstage 本文以 Backst…

阅读更多 →
Arduino-ESP32 ESP_Video 库实战指南:基于 MIPI-CSI 与 DVP 接口的 V4L2 风格摄像头采集 2026/9/13 15:45:27

Arduino-ESP32 ESP_Video 库实战指南:基于 MIPI-CSI 与 DVP 接口的 V4L2 风格摄像头采集

Arduino-ESP32 ESP_Video 库实战指南:基于 MIPI-CSI 与 DVP 接口的 V4L2 风格摄像头采集 【免费下载链接】arduino-esp32 Arduino core for the ESP32 family of SoCs 项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32 ESP_Video 是 arduino…

阅读更多 →
Tasmota 中的 ScioSense ENS16x 驱动库:ENS160/ENS161 四通道 MOX 气体传感器 I2C 使用指南 2026/9/13 15:42:27

Tasmota 中的 ScioSense ENS16x 驱动库:ENS160/ENS161 四通道 MOX 气体传感器 I2C 使用指南

Tasmota 中的 ScioSense ENS16x 驱动库:ENS160/ENS161 四通道 MOX 气体传感器 I2C 使用指南 【免费下载链接】Tasmota Alternative firmware for ESP8266 and ESP32 based devices with easy configuration using webUI, OTA updates, automation using timers or r…

阅读更多 →

今日资讯

本周资讯

本月资讯

看完文章仍有疑问?

联系尧图顾问,获取一对一建站咨询

立即免费咨询 📞 400-888-8888
📞