1仕組みと動作原理
方法論は「2軸」：縦軸で対象の誕生から現在までの全軌跡を時系列で再現し、横軸で現在の時間断面における競合比較を行い、最後に両軸を交差させて新たな判断を導き出す——3つのパートそれぞれに厳格な文字数範囲が定められており、要約ではなく深掘りを強制する。
hv-analysis/SKILL.md
## 第二步：纵向分析（Diachronic / Longitudinal） 沿时间轴，完整还原研究对象从诞生到现在的发展全貌。这是报告的主体部分，篇幅应该最重。
分量規定で3つのセクションを厳密に固定：縦方向 6,000〜15,000字、横方向 3,000〜10,000字、交差部 1,500〜3,000字、全体で 10,000〜30,000字とし、「浅い表面的な記述を許さない」ための定量化手段となっている。
品質の前提条件を必須要件として規定：資料が不足している場合は執筆を許可せず、情報収集段階では過剰なほど検索することを優先する。
hv-analysis/SKILL.md
这个方法论的质量完全取决于信息的丰富度和准确性。**必须联网搜索**，不能仅靠已有知识。研究报告的价值在于深度和完整度，所以信息收集阶段宁可多搜，不要因为信息不够导致后面的分析浮于表面。
Webアクセスアクションをツールとエンドポイントに具体化：メインエージェントがサブエージェントを並行して派遣して検索させ、各サブエージェントのプロンプトにWebSearch/WebFetchの使用ガイドラインと「学術対象に対するarXiv必修検索」のcurl呼び出し例を埋め込む。
hv-analysis/SKILL.md
**WebSearch**：用于搜索发现信息来源，获取摘要和关键词结果
同じセクションで、再現可能なarXiv API呼び出しと「WebSearchで手掛かりを見つけ、WebFetchで深掘りする」2段階戦略を提示し、プロンプトには手段（「検索」「スクレイピング」）ではなく目標（「取得」「調査」）を記述するよう推奨している。
オプションの機能強化：ユーザー環境にweb-access skill（ブラウザCDP機能を含む）がインストールされている場合は、それを優先的にロードする。
hv-analysis/SKILL.md
如果用户环境中安装了 web-access skill（检查路径 `/mnt/.claude/skills/web-access/SKILL.md` 是否存在），优先加载它并遵循其指引，它提供更强的浏览器CDP能力
ここでの処理内容：固定のローカルパスを検出することで、より強力なスクレイピング機能が備わっているかを判定。未インストールの場合はWebSearch/WebFetchにフォールバックする。
情報ソースの階層化制度を本文に明記：一次ソースを二次ソースより優先（公式ブログ/Release Notes/創業者ツイート > 権威メディアのオリジナル記事 > 転載・アグリゲーション）、各種情報に対応する一次ソース対照表を提供。
hv-analysis/SKILL.md
### 信息来源优先级 一手来源优于二手来源，多个媒体引用同一个错误会造成循环印证假象： | 信息类型 | 一手来源 | |---------|---------| | 产品更新/技术决策 | 官方博客、GitHub Release Notes、创始人推文 | | 融资/商业数据 | 公司官方公告、SEC/工商文件 | | 用户口碑 | GitHub Issues、Reddit讨论、Twitter/X、知乎帖子 | | 行业分析 | 权威媒体原创报道（非转载） | | 学术/技术原理 | arXiv论文（`export.arxiv.org/api/query`）、Google Scholar、学术会议论文集 |
PDF出力は組み込みスクリプトを使用：SKILL.mdに依存関係のインストール（pip install weasyprint markdown）と呼び出しコマンドを記載し、スクリプト内に完全なCSS組版（A4、表紙、4段階見出しの配色、ヘッダー/フッター、テーブルのゼブラ縞）を内蔵。
hv-analysis/SKILL.md
python [skill目录]/scripts/md_to_pdf.py input.md output.pdf --title "研究对象名称" --author "数字生命卡兹克"
本文の「スクリプト内蔵組版仕様」でページ/表紙/配色/フォント/本文/引用ブロック/テーブル/ヘッダー・フッターの仕様を箇条書きで定義。md_to_pdf.py内の@pageおよびCSS_TEMPLATEに対応。
執筆スタイルと「絶対的禁止事項」を分離：カズクならではの可読性（リズム、ナラティブアーク、段階的な展開、伏線回収）と研究レポートの構造的ナビゲーションを両立させ、避けるべきAI特有の定型句や捏造シナリオを列挙。
hv-analysis/SKILL.md
### 绝对禁区（依然适用） 以下AI味标记无论什么文体都要避免： - 套话："首先...其次...最后"、"综上所述"、"值得注意的是"、"不难发现" - 空洞形容词："赋能"、"抓手"、"打造闭环" - 教科书开头："在当今AI快速发展的时代"、"随着技术的不断进步" - 高频踩雷词："说白了"、"意味着什么？"、"这意味着"、"本质上"、"换句话说"、"不可否认" - 空泛工具名：不说"AI工具"、"某个模型"，要说具体名字 - 编造场景：如果某个信息搜不到，诚实标注「该信息暂缺」，绝不编造
同セクションでは「句読点の制約は緩和可能」「WeChat記事の三連フッターを追加しない」ことも明確にし、WeChat向け文体と研究レポートの体裁を明確に区別。
納品前に14項目の品質チェックリストを実施（ナラティブ形式、意思決定ロジック、競合シナリオ判定、実際のユーザーの声の引用、根拠ある3シナリオ推論、ソース明記、文字数範囲など）。
hv-analysis/SKILL.md
## 质检清单 交付前自检： - [ ] 纵轴是叙事故事体？读起来有因果逻辑和时代脉络？不是年表流水账？ - [ ] 创始人/发起者的背景和动机有足够深度？ - [ ] 每个关键节点都展开写了，没有为了压缩而跳过重要细节？ - [ ] 决策逻辑有还原？不只是「发生了什么」，还有「为什么这么选」？ - [ ] 横轴的竞品场景判断正确（A/B/C）？竞品分析够深？ - [ ] 用户口碑部分引用了真实用户的声音？不只是官方宣传？ - [ ] 横纵交汇产出了新的判断，不是前面内容的缩写版？ - [ ] 未来推演的三个剧本都有逻辑支撑？ - [ ] 写作风格有节奏感、有可读性？不是冷冰冰的咨询报告？ - [ ] 没有触犯绝对禁区里的任何一条？ - [ ] 所有关键事实标注了信息来源？ - [ ] 搜不到的信息诚实标注了「暂缺」，没有编造？ - [ ] PDF排版美观、结构清晰、可读性好？ - [ ] 总字数在 10,000-30,000 字的范围内？
2コア機能
01縦方向のライフサイクルナラティブ（起源/誕生の節目/変遷/意思決定ロジック/段階区分）
02横方向の競合比較（まず競合なし/少数/十分の3シナリオを判定し、差別化の次元に沿って展開）
03横縦の交差インサイト + 3シナリオによる未来推論（最も可能性が高い/最も危険/最も楽観的）
04並行サブエージェントによるWeb調査（縦/横/補足の3系統、プロンプトにツール利用ガイドを内蔵）
05学術対象に対するarXiv必修調査：直接実行可能なAPI呼び出しと論文ページの精読ルートを提供
06対象タイプ（プロダクト/企業/概念/人物）に応じた横縦の重点切り替え
07Markdownレポート → 美しく組版されたPDF（内蔵WeasyPrintスクリプト + 組み込みCSS）
08構造化リサーチデータ規約：references/schema.jsonで縦軸/横軸/交差部のマシンリーダブルなスキーマ骨格を提供
3外部依存関係
| Kind | Dependency / Endpoint |
|---|---|
| network | arXiv API（学术类研究对象必查） |
| network | arXiv 论文页（精读） |
| cli | curl |
| package | WeasyPrint + markdown（Python 包，PDF 渲染） |
| api | 宿主联网工具 WebSearch / WebFetch（未点名具体搜索后端） |
4推奨統制措置と判定根拠
安全運用のための推奨統制措置
Agent 向け
段階的・都度認可、サンドボックス推奨
管理者向け
承認フロー、ロールバック可能、全履歴監査
判定根拠（ファイルパスと抜粋）
- scripts/: ローカルスクリプトまたはコマンドの実行: scripts/md_to_pdf.py（ユーザーまたはエージェントによって実行されるローカルPython）：Markdownを読み込み、中間HTMLおよび最終PDFを出力；なし
- scripts/ 或 SKILL.md: 外部言語パッケージ依存関係の動的インストールを宣言
- 网络端点: 外部ネットワークアクセスの宣言: GET https://export.arxiv.org/api/query?search_query=... — 学術系研究対象の論文検索（SKIL
- 本地工作目录: ファイル読み書きおよび成果物出力: 研究段階：`[研究対象]_横縦分析報告.md`（Markdown原稿、ユーザーの作業ディレクトリに保存）
監査ノート： 。評価対象は本skillディレクトリ（SKILL.md + scripts/md_to_pdf.py + references/schema.json）です。実行時アクション＝固定された公開エンドポイントへのクエリと取得：SKILL.mdではarXiv API（export.arxiv.org、再現可能な生のcurlコマンドを提示）およびarxiv.org/abs論文ページを指定しており、その他の検索はホストのWebSearch/WebFetch経由で行われるため、外部送信先は予測可能です。認証情報/プライベートトークン/Cookieの読み取りはなく、ユーザー素材を外部の生成バックエンドに送信することもありません（レポートはローカルスクリプトでレンダリングされます）。そのためオレンジへの引き上げは行いません。追加の注意事項（判定変更なし）：① 付属スクリプトの依存関係インストールコマンドに `--break-system-packages` が含まれており、システムPythonのパッケージ管理保護をバイパスします；② レポート素材はWebスクレイピングから取得されるためインジェクション面が存在しますが、SKILL.mdには「信頼できないコンテンツ」としての降格宣言がありません（security.injection_surfaceに記録済み）。
5二重目の独立検証
- [ok] arxiv API 调用点真实存在 — SKILL.md 子 agent 指引段给出 `curl -s "https://export.arxiv.org/api/query?search_query=all:关键词1+AND+all:关键词2&max_results=10"`，并说明返回 XML（标题/作者/摘要/日期/PDF 链接），调用点真实。
- [ok] md_to_pdf.py 无网络/无子进程 — 脚本 import 仅 sys/os/re/argparse/markdown；无 requests/urllib/socket/subprocess；行为＝读 md、写 html、WeasyPrint 输出 pdf。
- [ok] CSS 与正文所述排版规范对应 — CSS_TEMPLATE 含 @page A4 margin 25mm/20mm、「第 X 页」@bottom-center、@page :first 隐藏页眉页脚等，与 SKILL.md「脚本内置的排版规范」一致。
- [ok] 第三方依赖与安装命令 — SKILL.md 两处写 `pip install weasyprint markdown --break-system-packages`（环境准备与生成 PDF 步骤各一次），已标为 yellow 的附加风险点。
- [ok] web-access skill 路径探测 — 原文为「如果用户环境中安装了 web-access skill（检查路径 `/mnt/.claude/skills/web-access/SKILL.md` 是否存在），优先加载它并遵循其指引」——是本地路径存在性判断，不产生网络请求。
- [ok] 字数指标一致性 — 纵向 6,000-15,000 + 横向 3,000-10,000 + 交汇 1,500-3,000 与「全文总计 10,000-30,000 字」及质检清单末条吻合。
- [ok] 来源分级与防循环印证 — 「一手来源优于二手来源，多个媒体引用同一个错误会造成循环印证假象」+ 五行信息类型/一手来源表逐字核对通过。
- [ok] 无凭证读取 — API_KEY/token/secret/keychain 零命中；全文不涉及登录态或私有 API。
6結論
最適な用途： プロダクト/企業/概念/人物の経緯や背景を体系的に把握したく、長文の生成とPDF出力を待てるシナリオに最適です。また、競合の横断比較 + 歴史的な縦断追跡を行い、美しく組版されたレポートを受け取りたいユーザーにも適しています。リサーチャー自身にとっても、サブエージェントの分担や情報ソース階層表はそのまま調査SOPとして再利用可能です。
不向きな用途： 単なる「XXとは何か」の用語解説を求める場合には不向き（descriptionで明確に除外）；WeChat公式アカウント（公众号）への投稿用（khazix-writerを使用）や単なるタイトル/要約生成には不向き；ネットワーク接続ができない、または外部検索が許可されていない環境には不向き（手法としてWebアクセスが必須要件）；トークンや時間コストに厳しい環境、あるいはWeasyPrintをインストールできない環境には不向き（PDF生成ステップが失敗します）。
Install Agent-Ready
① Verified Mirror 2026-09-15
Option A · Direct DownloadDownload hv-analysis.tar.gz
sha256:
Option B · Copy Guide for Agent9659c7f314c71b58…Agent はこの JSON ガイドから自動的にダウンロードして検証します。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit 48e8ba527f.