Hacktoberfest 2026：メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

[workshop-sync] side-quest-25-01-audit-reference.md: wrong artifact file names (safeoutputs.jsonl, mcp-logs/) and unverifiable "⌖ AIC" terminolo

オープン 初心者向け
  • 何か問題がありますか？
#4,451 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
84/100
issue の種類
バグ
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
javascript
領域
documentation

調査の方向性

まず workshop/side-quest-25-01-audit-reference.md を確認し、成果物名と AIC の用語を、参照先の成果物および監査・コスト管理のドキュメントと照合します。記載されているファイル名、MCP ログに関するガイダンス、分類器の AIC の表現を、それらの参照先に合わせて更新します。ワークショップのファイルで文書化された名称が使われ、Model Routing の文脈で分類器の AIC が説明されていれば完了です。

索引モデルが issue の本文から書いたものです。

説明

documentation

Workshop file reviewed

workshop/side-quest-25-01-audit-reference.md

Problem

  1. The agent artifact file table lists:

| safeoutputs.jsonl | Every safe-output declaration the agent emitted |

The live reference/artifacts/ doc names this file agent_output.json, not safeoutputs.jsonl — that filename does not appear anywhere in the artifacts documentation.

  1. The same table lists:

| mcp-logs/ | One log file per MCP server, listing every tool call and result |

Searching the raw HTML of both reference/artifacts/ and reference/audit/ for "mcp-logs" and "mcp_logs" returns zero matches. The documented structure for MCP/network traffic is the firewall-audit-logs artifact (downloaded via --artifacts mcp, per the Artifact Sets table: "mcp → firewall-audit-logs → MCP gateway traffic logs") or sandbox/firewall/logs/api-proxy-logs/ within the unified agent artifact — not a per-MCP-server mcp-logs/ directory.

  1. The file repeatedly uses a "⌖ AIC" / "Threat-detection AIC" metric:

**Threat-detection AIC (⌖ AIC)** — credits consumed by the firewall's threat-detection model, reported separately from agent inference
| ⌖ AIC | 3 | (in the sample audit report)
The **⌖ AIC** column in gh aw logs output shows credits consumed by the threat-detection model

Exhaustive searches of reference/audit/, reference/cost-management/, and the full gh aw CLI help snapshot found zero matches for "⌖" or "Threat-detection AIC". The actual documented term is "classifier AIC", part of the Model Routing summary for routed runs — a distinct concept from firewall threat detection.

Current correct behaviour

  • Safe-output data file: agent_output.json (per reference/artifacts/ → "agent" artifact section)
  • MCP/network traffic logs: firewall-audit-logs artifact or sandbox/firewall/logs/api-proxy-logs/ (per Artifact Sets table)
  • AIC routing terminology: "classifier AIC" (per reference/cost-management/ and reference/audit/), not "⌖ AIC" / "Threat-detection AIC"

The --parse flag, log.md/firewall.md output filenames, network.allowed frontmatter syntax, and the gh aw audit <run-id> --parse / gh aw logs <workflow-id> --artifacts all command forms in this file are all accurate and need no changes.

Suggested fix

  • Replace safeoutputs.jsonl with agent_output.json in the artifact file table.
  • Replace the mcp-logs/ row and the "Explore MCP tool calls" exercise with the documented sandbox/firewall/logs/api-proxy-logs/ path or firewall-audit-logs artifact (--artifacts mcp), and update the .github/aw/logs/<run-id>/mcp-logs/ path reference accordingly.
  • Replace "Threat-detection AIC (⌖ AIC)" and all "⌖ AIC" mentions (including in the sample report table and checkpoint) with the documented "classifier AIC" terminology, correcting the description to match its Model Routing context (routed runs only), or remove the bullet if no direct equivalent exists.

References: https://github.github.com/gh-aw/reference/artifacts/, https://github.github.com/gh-aw/reference/audit/, https://github.github.com/gh-aw/reference/cost-management/ (all confirmed reachable, HTTP 200)

Generated by 🔍 Workshop Sync Check · copilot · auto · 239.5 AIC · ⌖ 8.28 AIC · ⊞ 9.2K · ◷

  • expires on Oct 12, 2026, 5:49 AM UTC
主要言語
JavaScript
スター
52
フォーク
26
平均マージ
12時間 58分
マージ済み PR（30日）
15

環境構築

Codespaces で開く

このプロジェクトの開発コンテナを、あなたの GitHub アカウントでブラウザ上に起動します。

  • Dockerfile・Docker Compose ファイルなし
  • プルリクエストのテンプレートなし
  • コントリビューションガイドなし

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

githubnext/gh-aw-workshop のほかの issue

githubnext/gh-aw-workshop の issue をすべて見る

似ている issue

JavaScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。