mcpField
N
notis-reports

notis-reports

github.com/mindthefloドキュメント099 回インストール今日更新
リポジトリ

notis-reports について

Notis でレポートを読み取り、作成、修正するためのスキルです。保存済み HTML ページとインタラクティブな Space ビューを区別し、レポートの識別情報を保ちながら描画結果を確認し、依頼時のみ共有する手順を示します。

主な機能

  1. 01既存レポートの読み取りと描画
  2. 02Space への HTML ページ保存
  3. 03型付きパラメーターによるレポート作成
  4. 04識別情報を保ったレポート修正
  5. 05デプロイ済みビューとリンクの検証

活用シーン

  1. 01指定期間のレポート確認
  2. 02完成した HTML レポートの保存
  3. 03ライブデータを使ったレポート作成

MCP 対応

notis-apps のホスト型 MCP ドキュメントを参照し、Notis のビュー検索・描画操作でレポートを読み取ります。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/mindtheflo/notis-skills --skill notis-reports

インストール後、Claude Code で/notis-reportsを入力して読み込まれたか確認します。

同梱ファイルagents/openai.yaml

詳細

Notis レポート

レポートは独立した UI システムではなく、保存済みページまたはインタラクティブビューです。

  • 保存済みページまたはレポート(自己完結型の HTML、またはユーザーが保存を希望する完成済みレポート):最も適切な Space 内のページ。デフォルトでは、Notis Notes の Notis reports フォルダー内のノートです。HTML ページまたはレポートを保存するをご覧ください。
  • インタラクティブレポート(期間などの型付きパラメーター、ライブデータの読み取り):独自のソース、データ宣言、メモリーポリシーを持つ、個別に作成された Space ビューです。あるレポートを編集しても、無関係なビューを置き換えてはなりません。

Spaces 導入前に保存されたページやレポートも、保存時の形式のまま Notis Notes に保管されています。HTML ページは全画面表示され、保存済みのレポート記録はレポートとして表示されます。実行環境で兄弟リファレンスを参照できない場合は、名前を指定して notis-apps を読み込んでください。

既存のレポートを読む

質問に答えられる場合は、ネイティブのデータツールを使用してください。ライブの数値、グラフ、フィルター、HTML、または目視での確認には、notis-apps を読み込み、読み取りとレンダリングガイド(ホスト型 MCP:notis://docs/notis-apps/references/reading.md)に従ってください。

LOCAL_NOTIS_FIND_VIEWS で対象となる正確なレポート期間と現在のビューリンクを特定し、LOCAL_NOTIS_RENDER_VIEW でレンダリングしてください。Markdown と画像の出力を確認します。読み取りによって過去の数値が再生成されたり、ソースやデータの変更が許可されたりすることはありません。

HTML ページまたはレポートを保存する

最も適切な Space、つまりユーザーが指定した Space、またはページを保管する作業対象の Space に保存します。それ以外の場合は、Notis Notes の Notis reports フォルダー(またはユーザーが指定した Notes フォルダー)に保存してください。Save HTML Skill は、フォルダーが存在しない場合に作成します。「すべてのノート」ではこれらのノートは表示されませんが、各フォルダーにはその中のすべての項目が表示されます。

  1. その Space がページ用に提供する Skill を使って保存します。Notes の場合は Save HTML Skill を使用します。この Skill はノート(タイトル、種類「Report」または「HTML page」、フォルダー)を作成し、汎用のネイティブファイルツールで元のバイト列をアップロードし、返されたファイルを別途、リビジョンを確認して更新する操作で添付し、ノートを読み戻してリンクを返します。このガイドでは、そのワークフローを重複して説明しません。
  2. 修正する場合は、ほぼ同じ内容の別ページを作るのではなく、同じ Skill を使って同じページを更新します。Spaces 導入前から保存されているレポート記録は、どのツールでも書き換えられません。修正版を同じフォルダーに新しいページとして保存し、元のページはそのまま残してください。
  3. アップロードに成功しただけではページを保存したことにならず、ファイル URL はページリンクではありません。Space 内のページリンクを返してください。このリンクを開くと全画面表示されます。
  4. ページは非公開のままにします。依頼された場合に限り、Share を使ってそのページの公開リンクを作成してください。Spaces 導入前から保存されているレポートは共有できません。
  5. ページの保存先が Notes で、Notis Notes がインストールされていない場合は、インストールを提案してください。Space 外にページを保存してはなりません。ウェブサイト、公開ペーストサービス、ファイルホスト、サンドボックスのダウンロードリンクへの保存も禁止です。HTML やレポート専用の保存ツールはありません。

インタラクティブレポートの作成または改訂

  1. まず本人確認を調整します。修正依頼の場合は、既存のレポート Space を探します。選択されている本人確認情報とリビジョンを保持してください。名前が似ているレポートは同じ成果物ではありません。
  2. 新しい独立したレポートの場合は、notis-apps のビューの作成、デザイン、配信に従います。レポートの期間や選択条件を型付きパラメーターとして宣言し、実データを shows または宣言済みアクションに含め、明確なソースコンテキストと適切なメモリポリシーを指定します。
  3. ユーザーの依頼に応じて、取得済みの結果、ライブ読み取り、またはその両方を選択します。改訂を依頼されていない限り、過去の結果は取得済みの状態を維持します。単位、期間、方法、ソースへのリンクを見えるようにします。正確に Markdown へ抽出できるよう、実際のチャート値を含む <RenderChartData> を指定します。
  4. ビルドし、架空のフィクスチャで検証して、390px/1440px で EN/FR を確認します。その後、ユーザーの許可範囲内で確認済みのソースをデプロイし、リビジョンを読み戻して、実際に保存されたビューをレンダリングします。プレビューは正式な成果物ではありません。
  5. 現在のビューへのリンクと、正確な検証範囲を提示します。ストアへの公開は、許可されたレポート Space の更新を保存することとは別です。

任意の受動的なフィードバック

ユーザーがエージェントに戻したい選択テキスト、コメント、注釈には、コンテキスト共有を使用します。フィードバックは参照用のコンテキストであり、実行の承認ではなく、それ自体でメッセージを送信することもありません。

コメント