Skip to content

仕様書を構造化する(Applications / Spec Hub)

Chihoの「Applications」機能は、ソフトウェア開発プロジェクトなどで発生する複雑な「仕様書」を、ツリー構造で体系的に管理するための機能です。その中核をなすのが「Spec Hub」と呼ばれるシステムです。

開発プロジェクトでは、要件やページ構成といった仕様情報が様々なドキュメントに散らばりがちです。この機能は、それらの情報を一元的に、かつ構造的に管理することで、チーム内の認識齟齬を防ぎ、開発プロセス全体を効率化します。

1. 「Applications / Spec Hub」機能の主な役割

この機能は、プロジェクトの設計図をチームで共有・管理するための強力なツールです。

役割説明
① 仕様の一元管理と構造化システムの要件や仕様を、フォルダとファイルのようなツリー構造で視覚的に分かりやすく管理します。これにより、システム全体の構造を直感的に把握できます。
② 認識齟齬の防止チーム全員が常に最新の正しい仕様書にアクセスできるため、「言った言わない」や古い情報に基づく手戻りを防ぎます。
③ AIとの強力な連携構造化された仕様書群を、ワンクリックで一つのドキュメントにまとめることができます。このドキュメントをAIに「知識」として与えることで、仕様を正確に理解したAIがコード生成などを行えるようになります。

2. 仕様を作成・管理する手順

Step 1: 仕様(要件)を作成し、ツリーを構築する

  1. サイドメニューの「Applications」を選択します。

  2. 要件作成画面で、以下の内容を入力し、仕様を一つずつ作成していきます。

    • タイトル (Title)
    • 要件内容 (Content)
    • フォルダの選択 (Parent): どの階層に配置するかを選択します。

  3. これを繰り返すことで、プロジェクトの仕様がツリー形式で体系的に整理されていきます。

Step 2: ツリーからドキュメントを生成する

AIに仕様を教えたり、関係者に仕様書全体を共有したりするために、ツリーの一部を一つのドキュメントにまとめます。

  1. まとめたいフォルダ(例:機能一覧)の右側にある「・・・」メニューをクリックし、「Generate Document」 を選択します。

    (操作手順)

  2. ドキュメントが生成されたら、「Go to Document」 をクリックして内容を確認します。

  3. 選択したフォルダ以下のすべての仕様が、見出し付きの一つのMarkdownドキュメントとしてきれいにまとめられていることが確認できます。


3. AIとの連携:仕様書をAIの知識へ

この機能の真価は、生成したドキュメントをAIエージェントに知識として与える(アタッチする)ことで発揮されます。

必要な部分だけをドキュメント化してAIに渡すことで、AIはプロジェクトの仕様を正確に理解し、より精度の高いコードやテストケース、仕様に関する質疑応答などを生成できるようになります。


まとめ:組織の知を集約する「中央図書館」

「Applications / Spec Hub」機能は、組織の知的資産、特に複雑なプロジェクトの仕様書を構造的に整理し、AIと共に活用するための「設計図管理システム」です。

この機能を活用することで、情報は常に整理され、チームの生産性を向上させるだけでなく、AIをプロジェクトの強力なアシスタントとして活用するための道が開かれます。