ai-agent-book 精选快照（<2MB 代码与文档，来自 github.com/bojieli/ai-agent-book）

2026-08-20 13:12:50 +00:00
commit b119135836
10275 changed files with 3284984 additions and 0 deletions
@@ -0,0 +1,3 @@
+{
+  "return_code": 1
+}
@@ -0,0 +1,18 @@
+[
+  "claude",
+  "--print",
+  "--output-format",
+  "stream-json",
+  "--verbose",
+  "--model",
+  "sonnet",
+  "--effort",
+  "high",
+  "--max-budget-usd",
+  "8",
+  "--no-session-persistence",
+  "--dangerously-skip-permissions",
+  "--add-dir",
+  "/Users/boj/book/ai-agent-book/chapter2/agent-skills-ppt/external/anthropics-skills/skills/pptx",
+  "/pptx\n\nCreate a polished 10\u201315 slide presentation from the real academic paper at\n`attention-is-all-you-need.pdf`. Write the final deck to\n`output/attention-is-all-you-need.pptx`.\n\nThis is an audited Agent Skills experiment. Follow the official PPTX Skill by\nprogressive disclosure: invoke the pptx Skill, read its complete SKILL.md, then\nread its complete html2pptx.md only after selection. Use the pinned official\n`scripts/html2pptx.js` workflow. Use the official `scripts/thumbnail.py` to\nmake `output/full-deck-thumbnail.jpg`, inspect the full grid, and fix visible\noverlap, cutoff, contrast, or alignment defects before finishing.\n\nContent gates:\n- cover title, problem/background, Transformer method/architecture, key\n  experimental results, and conclusion;\n- extract or crop at least three visuals directly from the source PDF (not\n  invented replacements), place the files under `source_visuals/`, and embed\n  all of them in the deck;\n- create `source_visuals/manifest.json` as a JSON list. Each item must contain\n  `file`, one-based PDF `page`, the paper's `label` (for example Figure 1 or\n  Table 2), and a faithful `caption`;\n- make every visual consistent with the surrounding slide explanation and\n  cite its source page/label on-slide.\n\nYou may install the Node packages required by the official Skill inside this\nworkspace. Do not use the repository's bundled `demo.py`, local proxy Skill,\nor prewritten sample outline. The final response must name the deck,\nthumbnail, visual manifest, slide count, validation performed, and any\nremaining limitation.\n"
+]
@@ -0,0 +1,59 @@
+{
+  "experiment_id": "2-6",
+  "protocol_sha256": "2990c8ef624edc12a06fb1b622de33b0fe8842cc5b42faf85788850111265eba",
+  "official_skill_receipt": {
+    "repository": "https://github.com/anthropics/skills.git",
+    "revision": "69c0b1a0674149f27b61b2635f935524b6add202",
+    "skill_path": "/Users/boj/book/ai-agent-book/chapter2/agent-skills-ppt/external/anthropics-skills/skills/pptx",
+    "required_file_hashes": {
+      "skills/pptx/SKILL.md": "b6f25545bfb358739f1532f793458b5dbc87ee009933cb7c306b2d951ab6617f",
+      "skills/pptx/html2pptx.md": "f08ed7580969b796d9cd5ade93e2cdee981dcaf13cc5eb12e8d4a3700c2d6047",
+      "skills/pptx/scripts/html2pptx.js": "c675d09a54d6a002e8ca5917b9d24a6568aa8d455bb7abeb212d4f564dd07a34",
+      "skills/pptx/scripts/thumbnail.py": "c21fd950b6ada7bd2f029885d3e56bc66b7ff061cc8404c492eb301664aa9e5d"
+    }
+  },
+  "claude_result": {},
+  "slide_count": 0,
+  "section_checks": {
+    "title": false,
+    "background": false,
+    "method": false,
+    "results": false,
+    "conclusion": false
+  },
+  "source_visuals": [],
+  "embedded_media": {},
+  "thumbnail_files": [],
+  "gates": {
+    "source_pdf_hash_matches": true,
+    "claude_run_succeeded": false,
+    "pptx_skill_invoked": false,
+    "skill_md_loaded": false,
+    "html2pptx_guide_loaded": false,
+    "official_html2pptx_used": false,
+    "official_thumbnail_used": false,
+    "thumbnail_visually_inspected": false,
+    "pptx_zip_valid": false,
+    "pptx_reopens": false,
+    "slide_count_in_range": false,
+    "required_sections_present": false,
+    "three_source_visuals_embedded_and_documented": false,
+    "thumbnail_grid_present": false,
+    "credential_scan_passed": true
+  },
+  "official_complete": false,
+  "artifacts": {
+    "experiment_protocol.json": {
+      "sha256": "2990c8ef624edc12a06fb1b622de33b0fe8842cc5b42faf85788850111265eba",
+      "bytes": 2582
+    },
+    "claude_stream.jsonl": {
+      "sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
+      "bytes": 0
+    },
+    "workspace/attention-is-all-you-need.pdf": {
+      "sha256": "bdfaa68d8984f0dc02beaca527b76f207d99b666d31d1da728ee0728182df697",
+      "bytes": 2215244
+    }
+  }
+}
@@ -0,0 +1,52 @@
+{
+  "experiment_id": "2-6",
+  "protocol_version": "1.0.0",
+  "frozen_on": "2026-07-30",
+  "authority": "book/chapter2.md:767",
+  "runtime": {
+    "agent": "Claude Code",
+    "model_alias": "sonnet",
+    "official_skill_repository": "https://github.com/anthropics/skills.git",
+    "official_skill_revision": "69c0b1a0674149f27b61b2635f935524b6add202",
+    "skill_path": "skills/pptx",
+    "revision_reason": "This is the official revision whose PPTX Skill contains the html2pptx.md workflow named by the manuscript; later revision 4e6907a packages that guide as html2pptx.tgz."
+  },
+  "paper": {
+    "title": "Attention Is All You Need",
+    "authors": "Ashish Vaswani et al.",
+    "arxiv_id": "1706.03762",
+    "pdf_url": "https://arxiv.org/pdf/1706.03762",
+    "pdf_sha256": "bdfaa68d8984f0dc02beaca527b76f207d99b666d31d1da728ee0728182df697"
+  },
+  "output": {
+    "minimum_slides": 10,
+    "maximum_slides": 15,
+    "required_sections": [
+      "title",
+      "problem/background",
+      "method/Transformer architecture",
+      "key results",
+      "conclusion"
+    ],
+    "minimum_paper_visuals": 3,
+    "visual_policy": "At least three images must be extracted or cropped from the source PDF, embedded in the deck, and listed with PDF page and source label in source_visuals/manifest.json."
+  },
+  "progressive_disclosure_gates": [
+    "Claude Code discovers only PPTX Skill metadata before selection",
+    "Claude invokes the official pptx Skill and loads its complete SKILL.md",
+    "Claude reads the complete official html2pptx.md only after selecting the Skill",
+    "Claude uses the official scripts/html2pptx.js workflow",
+    "Claude invokes the official scripts/thumbnail.py preview workflow and visually inspects the result"
+  ],
+  "artifact_gates": [
+    "the source PDF hash matches the preregistered academic paper",
+    "the presentation is a valid ZIP/OOXML package and python-pptx reopens it",
+    "slide count is between 10 and 15 inclusive",
+    "the five required content sections are present",
+    "three or more source visual files are byte-identical to media embedded in the PPTX",
+    "each source visual has a PDF page, paper label, and caption in the visual manifest",
+    "a full-deck thumbnail grid exists",
+    "raw Claude Code stream events, actual model, usage/cost, commands, hashes, and credential scan are retained"
+  ],
+  "claim_policy": "The bundled Python demo is a noncanonical mechanism illustration and cannot satisfy Experiment 2-6. Only a real Claude Code run with the pinned official Skill and real paper can complete this protocol."
+}
@@ -0,0 +1,7 @@
+{
+  "experiment_id": "2-6",
+  "official_complete": false,
+  "protocol_sha256": "2990c8ef624edc12a06fb1b622de33b0fe8842cc5b42faf85788850111265eba",
+  "comparison_sha256": "688774e2a47eabef59f7dba27f999aeb0a3936472db1bb4584078f317c518f58",
+  "pptx_sha256": null
+}
@@ -0,0 +1,11 @@
+{
+  "repository": "https://github.com/anthropics/skills.git",
+  "revision": "69c0b1a0674149f27b61b2635f935524b6add202",
+  "skill_path": "/Users/boj/book/ai-agent-book/chapter2/agent-skills-ppt/external/anthropics-skills/skills/pptx",
+  "required_file_hashes": {
+    "skills/pptx/SKILL.md": "b6f25545bfb358739f1532f793458b5dbc87ee009933cb7c306b2d951ab6617f",
+    "skills/pptx/html2pptx.md": "f08ed7580969b796d9cd5ade93e2cdee981dcaf13cc5eb12e8d4a3700c2d6047",
+    "skills/pptx/scripts/html2pptx.js": "c675d09a54d6a002e8ca5917b9d24a6568aa8d455bb7abeb212d4f564dd07a34",
+    "skills/pptx/scripts/thumbnail.py": "c21fd950b6ada7bd2f029885d3e56bc66b7ff061cc8404c492eb301664aa9e5d"
+  }
+}
@@ -0,0 +1,30 @@
+/pptx
+
+Create a polished 10–15 slide presentation from the real academic paper at
+`attention-is-all-you-need.pdf`. Write the final deck to
+`output/attention-is-all-you-need.pptx`.
+
+This is an audited Agent Skills experiment. Follow the official PPTX Skill by
+progressive disclosure: invoke the pptx Skill, read its complete SKILL.md, then
+read its complete html2pptx.md only after selection. Use the pinned official
+`scripts/html2pptx.js` workflow. Use the official `scripts/thumbnail.py` to
+make `output/full-deck-thumbnail.jpg`, inspect the full grid, and fix visible
+overlap, cutoff, contrast, or alignment defects before finishing.
+
+Content gates:
+- cover title, problem/background, Transformer method/architecture, key
+  experimental results, and conclusion;
+- extract or crop at least three visuals directly from the source PDF (not
+  invented replacements), place the files under `source_visuals/`, and embed
+  all of them in the deck;
+- create `source_visuals/manifest.json` as a JSON list. Each item must contain
+  `file`, one-based PDF `page`, the paper's `label` (for example Figure 1 or
+  Table 2), and a faithful `caption`;
+- make every visual consistent with the surrounding slide explanation and
+  cite its source page/label on-slide.
+
+You may install the Node packages required by the official Skill inside this
+workspace. Do not use the repository's bundled `demo.py`, local proxy Skill,
+or prewritten sample outline. The final response must name the deck,
+thumbnail, visual manifest, slide count, validation performed, and any
+remaining limitation.