合同会社ヴォール

21/08/2026

Windows 11のHyper-V上にUbuntu Server 24.04とHermes Agentを構築し、PCの起動に合わせて常時稼働する環境を作りました。

今回の記事では、インストールだけでなく、実運用に必要だった設定を一通りまとめています。

Hyper-V VMと外部仮想スイッチの作成
Hermes AgentとLLMの設定
Telegram Botからの利用
Gatewayのsystemd常駐化
Web DashboardへのLAN内アクセス
Chromium CDPによるブラウザ操作
Context Mode MCPとRouting Skill
日次ニュースを配信するCron
タイムゾーンやモデル固定
実際に遭遇したエラーと対処方法
特に、libatomic.so.1エラー、LiteLLMのreasoning_effort問題、Cronのモデル設定差分によるskip、90秒タイムアウト、Chromiumのsandboxエラーなど、構築中に詰まりやすい部分も記録しました。

Windowsへログインして手動でアプリを開かなくても、PCを起動すればTelegramからHermes Agentを利用できる構成です。

▼構築手順はこちら
https://wohl-yz.net/archives/hermesagent

14/08/2026

GitHub Spec Kit と spec-workflow-mcp を、自作のMCPサーバーで連携してみました。

Spec Kitで仕様を作成し、spec-workflow-mcpでブラウザ承認・タスク管理・進捗可視化を行う構成です。

記事では、
・なぜこの2つを組み合わせたのか
・MCPサーバーがMCPクライアントにもなる構成
・MCP Samplingを使った自動変換
・Gooseのレシピ／スキルによる運用自動化
・実際に19タスクを最後まで実装した結果
まで、つまずいたポイントも含めてまとめています。

AIコーディングで「仕様を作る」だけでなく、「人間が承認してから実装に進む」流れを作りたい方におすすめです。

https://wohl-yz.net/archives/speckit

20/07/2026

本を抜くだけで学習時間を自動記録するスマート本棚「StudyShelf」
本を抜くと学習開始、棚へ戻すと自動で記録。
高校受験に向けた家庭学習を、子どもへ余計な入力操作を求めず記録するため、スマート本棚「StudyShelf」を開発しました。
M5Stack Tab5と10個のマイクロスイッチを使い、教材ごとの学習時間を自動記録。Notionから今日の学習予定を取得し、画面で完了した情報もNotionのデータベースへ自動反映します。
開発にはCodexとClaude Codeを活用し、私自身はソースコードを一切記述していません。spec-workflow-mcpによる仕様駆動開発では、13件の仕様書と171件のタスクを作成。OpenSCADによるケースや本棚の設計もAIを活用しました。
家庭学習、IoT、AIノーコード開発を組み合わせた開発過程を詳しく紹介しています。

https://wohl-yz.net/archives/smartstudyshelf

#仕様駆動開発

教材を本棚から抜くと学習を開始し、戻すと時間を自動記録する「Smart StudyShelf」を開発しました。M5Stack Tab5、Notion、Codex、Claude Code、仕様駆動開発、OpenSCADを活用した家庭学習向けIoTデバイスの開発過程を紹介します。

28/05/2026

【実践録】Zedで作る仕様駆動AI開発環境！Agentの役割分担とルール作り

「AIにコードを書かせたら、頼んでいない機能まで勝手に作られてしまった…」
最近のAIコーディングで、そんな経験はありませんか？

エディタ内蔵AgentやMCPサーバーなど、AI開発環境が急速に複雑化する中、今回はあえてシンプルに「Zedを中心とした仕様駆動開発環境」を構築した実践メモを公開しました！

💡 本記事のハイライト
明確な分業体制: Zed Agent (仕様) × Codex (実装) × OpenCode (レビュー) の最適な役割分担
仕様の正本管理: spec-workflow-mcp を使って要件と設計をMarkdownファイルで共通化
現場のリアル: あえて「Superpowers」プラグインの導入を見送った理由
暴走ストッパー: 全Agent共通の作業ルールを定義する AGENTS.md の実例

これからAIコーディング環境を本格的に整備したい方、Agentの使い分けに悩んでいる方は、ぜひ記事をチェックしてご自身のプロジェクトに取り入れてみてください！

👇 環境構築の詳しい手順と設定ファイルはこちらから
https://wohl-yz.net/archives/zed-spec-workflow

Zedエディタとspec-workflow-mcpを組み合わせた仕様駆動AI開発環境の構築手順を解説。Zed Agent、Codex、OpenCodeの役割分担や、Superpowers導入を見送った理由まで、実践的なノウハウを公開。AIの過剰実装を防ぐ環境作りの参考に！

23/02/2026

ZeroClawで作るWSL2のセキュアなローカルAIエージェント環境構築

Rust製で爆速・軽量な「ZeroClaw」の構築ガイドを書きました。OpenClawとの比較や、Windowsドライブを強制アンマウントするセキュリティ設定、OpenRouter経由のDeepSeekでの格安運用まで。

Rust製の軽量AIエージェント「ZeroClaw」をWSL2上でWindowsから隔離したセキュアな環境を構築する完全手順を公開します。DeepSeek×OpenRouterによるコスト最適化や、Braveの接続、自動起動設定まで、実運用に必須のノウハウを凝縮し....

21/02/2026

ローカルLLM × リアルタイム検索！Nemotron-Nano-9B-v2-Japanese + LM Studio + Tavily MCP で作るインターネット対応AIアシスタント

NVIDIAの日本語特化モデル「Nemotron-Nano-9B-v2-Japanese」とTavilyを連携させて、完全無料＆ローカルで動くAIアシスタントを構築しました🛠️
構築の全手順はこちら👇

クラウド不要・完全無料で使える！LM StudioとNVIDIAの日本語特化ローカルLLM「Nemotron-Nano-9B-v2-Japanese」、Tavily MCPを組み合わせて、最新のWeb検索が可能なAIアシスタントを構築する手順を全ステップ解説します。

08/02/2026

【ローカルLLM】GLM-OCRで日本語環境を作ったら「中国語の壁」にぶつかった話と、その解決策

最近話題の「GLM-OCR」を試してみたのですが、認識精度は高いものの「漢字が中国語になる」という壁にぶつかりました。（「経済」が「经済」になったり…）
これを解決するために、PythonとOpenCCの辞書データを使って、レイアウト情報を崩さずに日本語漢字に直すコンバータを自作しました。

OllamaのGLM-OCRで日本語OCRを行うと漢字が簡体字になる問題を、OpenCC辞書の直接読み込みと「保護リスト」による過剰変換防止ロジックで解決！Table/Text Recognitionを両立させるプロンプトの工夫から、WindowsでのPython環境構築手順...

07/02/2026

ObsidianでPDF仕様書を作成する：CSSスニペット活用術

これまでAsciidocやNotionを使っていた仕様書作成を、ローカルファイルベースのObsidianに移行しました。 CSSスニペットを活用することで、仕様書レイアウトのPDFが作れるようになります。その構築ノウハウをブログにまとめました。

【本記事で実現できること】
📄 Obsidianから表紙・目次付きのPDFエクスポート
🔄 縦横混在レイアウト（システム構成図だけ横向きなど）
📤 Gitによる変更履歴管理
📃 見出しごとの改ページ制御

ObsidianでPDF仕様書を作成する方法を解説。CSSスニペットを活用した表紙作成、改ページ制御、縦横混在レイアウトの実現手法から、Gitによるバージョン管理、Mermaid図表の最適化まで、エンジニア向けの実践的なTipsを凝縮し.....

31/01/2026

【AI開発環境】Cursorへのspec-workflow と superpowers の導入ガイド

仕様を伝えて、AIが計画を立て、人間が承認し、AIが実行する。
そんな「人間とAIの協調ワークフロー」を、今すぐCursorで再現できます。
spec-workflow で上流を管理し、superpowers で実装を自動化。

AIエディタCursorでエージェント能力を最大化！「spec-workflow」と「OpenSkills(superpowers)」の導入ガイドです。MCPを活用し、AIに専門スキルをインストール。仕様策定から実装計画、自動実行まで、開発を加速させる強力なワーク.....

30/01/2026

【AI開発環境】上流工程で品質確保・実装でコスト削減：spec-workflow-mcpとobra/superpowersによるAI駆動開発環

最近話題の spec-workflow-mcp と obra/superpowers を組み合わせてみました。

✅ Webダッシュボードで仕様を人間が承認
✅ 実装計画とTDDはAIが自動実行
✅ 複雑な推論と高速な実装をモデル切り替えで両立

要件定義から実装まで、AIエージェントと協働する完全フローの記録です。

【AI開発環境】spec-workflow-mcp、Claude Code Router、obra/superpowers、tmuxを統合した開発ワークフロー。上流工程の承認システムから、低コストモデルを用いた高速実装まで、ToDoアプリ開発の実例付きで完全解説。