Skip to content
Back to search

ai-assistant-workspace

あなた専用のAIアシスタント・ワークスペースです。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/karaage0703--ai-assistant-workspace/badge.svg)](/listings/karaage0703--ai-assistant-workspace)

HTML

<a href="/listings/karaage0703--ai-assistant-workspace"><img src="/api/listings/karaage0703--ai-assistant-workspace/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 245 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # ai-assistant-workspace
  2. あなた専用のAIアシスタント・ワークスペースです。
  3. AIコーディングツール(Claude Code / Codex CLI / Grok CLI など)を、継続的なパーソナルアシスタントとして使うためのスターターキットです。初回起動時に対話形式で設定を作り、以後はファイルに残した記憶・ルール・スキルを読みながら動きます。
  4. [xangi](https://github.com/karaage0703/xangi)(Discord常駐型AIアシスタント)の推奨ワークスペースです。xangiと組み合わせることで、チャットからスキルを呼び出して日常タスクを自動化できます。
  5. このワークスペースは、単なるプロンプト集ではありません。`AGENTS.md`、`MEMORY.md`、`memory/`、`notes/`、`skills/` を組み合わせて、AIアシスタントがセッションをまたいで文脈を読み、必要なスキルを選び、作業結果をファイルに残すための実運用テンプレートです。
  6. 背景にある考え方は、技術同人誌「[生活に溶け込むAI](https://karaage0703.booth.pm/items/8027277)」で紹介しています。書籍の紹介記事は「[技術同人誌『生活に溶け込むAI — AIエージェントで作る、自分だけのアシスタント』を販売しました](https://karaage.hatenadiary.jp/entry/2026/02/25/073000)」を参照してください。
  7. ## できること
  8. 同梱スキルは「全部使う」前提ではありません。必要なものだけ残して、自分の環境に合わせて削ってください。
  9. - **記録** — 調査結果・アイデア・会議メモ・日記を `notes/` と `memory/` に保存
  10. - **検索** — xangi-searchを追加すると、ワークスペース内のメモや判断を横断検索
  11. - **開発** — ブランチ運用、PR作成、コードレビュー、リポジトリ分析
  12. - **知識収集** — テックニュース、arXiv、YouTube、ポッドキャスト
  13. - **生活ログ** — カレンダー、健康管理、ペット写真などの任意スキル
  14. - **外部連携** — Notion、Google Workspace、xangi など。認証情報を設定した場合だけ使う
  15. - **スキル作成** — 自分だけのカスタムスキルを作る
  16. ## 基本コンセプト
  17. ### ファイルを記憶にする
  18. AIコーディングツールが提供する会話履歴や再開要約を活かし、不足する文脈は次のファイルから補います。ファイルへ記録することで、新しいセッションにも情報を引き継げます。
  19. - `AGENTS.md`: アシスタントの行動ルール、手順、安全ルール
  20. - `MEMORY.md`: 長期的に残したい近況・プロジェクト・好み
  21. - `memory/YYYYMMDD.md`: その日の作業ログ、日常ログ、判断メモ
  22. - `notes/`: 後から読み返す調査結果、企画、レビュー、日記
  23. 重要なのは「覚えておく」ではなく「ファイルに書く」ことです。ファイルに残せば、Claude Code / Codex CLI / Grok CLI / xangi など複数の入口から同じ文脈を再利用できます。
  24. ### スキルで行動を増やす
  25. `skills/` に `SKILL.md` を置くと、AIアシスタントは依頼内容に応じて必要な手順を読み込みます。日記、健康管理、コードレビュー、開発ワークフローなどをスキルとして分離することで、プロンプトを巨大化させずに機能を増やせます。
  26. ### 複数AIの意見を検証して統合する
  27. `xs-multi-agent` はCodex、Claude、Grok、Cursor、AntigravityなどのCLIを毎回検出し、実際に利用可能なagentだけへ依頼します。未インストール、ログイン切れ、クォータ不足はそのturnの候補から外し、外部agentが0件でも現在のAIセッションだけで作業を継続します。
  28. 「複数起動した」だけを合意とは扱いません。異なるproviderへ同じ統合質問を渡し、空回答や途中終了を除外した成果物が2系統以上あることを `validate_panel.sh` で確認します。
  29. ### xangi-searchで過去の文脈を探す
  30. ワークスペース検索には、xangiの公式Extensionカタログから追加できる [xangi-search](https://github.com/karaage0703/xangi-search) を推奨します。xangi Web UIの「拡張」でxangi-searchを追加し、表示されるセットアップ手順に従ってください。検索機能とAI向けスキルはxangi-search側で管理されるため、このリポジトリには検索エンジンを同梱しません。
  31. xangi-searchは任意です。導入していない場合も、AIは通常のファイル読み取りや文字列検索を使って、このテンプレートの記録・スキル・開発機能を利用できます。xangiを使わず単独CLIとして利用する方法は、xangi-searchのREADMEを参照してください。
  32. ### 長時間処理は復帰導線を作る
  33. Docker build、動画処理、外部AIの並列レビューなど時間がかかる処理は、親プロセスの終了から分離して実行し、PID・ログ・終了コードを残します。Linux / WSLでは`setsid bash -lc`、macOSではlaunchdなどOSのservice managerを使います。`nohup ... &` 単独は環境によって親process groupの終了に巻き込まれるため、同等の代替にはなりません。xangiで使う場合は、成功・失敗のどちらでも終了状態を保存した後に `xangi tool trigger` で自分を起こす導線を付けます。具体例は `AGENTS.md` の「長時間タスク」を参照してください。
  34. ## クイックスタート
  35. ### 必要なもの
  36. - [Claude Code](https://docs.anthropic.com/en/docs/claude-code/overview)、[Codex CLI](https://github.com/openai/codex)、Grok CLI などのAIコーディングツール
  37. - チャット常駐で使う場合: [xangi](https://github.com/karaage0703/xangi)
  38. - 外部サービス連携を使う場合: Notion / Google / Discord / Slack などのAPIキーやBot token
  39. ### 推奨: xangiで使う
  40. ```bash
  41. xangi setup
  42. ```
  43. セットアップでは既存ワークスペースを選ぶか、このリポジトリを推奨テンプレートとして取得できます。まずWeb Chatをローカルで起動・確認し、必要に応じてDiscord / Slack / LINE / Telegramなどを追加します。secret設定が必要な場合は、AIとの会話へ値を貼らず、ローカル設定画面を使います。
  44. ```bash
  45. xangi settings
  46. ```
  47. xangi-searchを使う場合は、Web UIの「拡張」から追加します。初回起動時から公式候補として表示され、追加後は専用のセットアップ会話が案内します。
  48. xangiのインストール、対応AI、サービス起動、各チャット連携、Extension管理の最新手順は [xangi](https://github.com/karaage0703/xangi) のREADMEと同梱ドキュメントを正本として参照してください。このワークスペースは、AIの人格・記憶・スキル・ユーザーデータを管理し、xangi本体の起動手順やsecret値は管理しません。
  49. ### AI CLIから直接使う
  50. xangiを使わず、AI CLIからこのワークスペースを直接開くこともできます。
  51. ```bash
  52. # 1. リポジトリをクローン
  53. git clone https://github.com/karaage0703/ai-assistant-workspace
  54. cd ai-assistant-workspace
  55. # 2. AIツールを起動(いずれか)
  56. claude # Claude Code の場合
  57. codex # Codex CLI の場合
  58. ```
  59. 初回起動時に`BOOTSTRAP.md`の対話セットアップが始まります。Claude Code用の`.claude/skills`、Codex CLI用の`.agents/skills`、Grok CLI用の`.grok/skills`を同梱しているため、クローンしたスキルをそのまま利用できます。
  60. ## ディレクトリ構成
  61. ```
  62. ai-assistant-workspace/
  63. ├── AGENTS.md # 設定ファイル(全ツール共通)
  64. ├── CLAUDE.md # → AGENTS.md へのシンボリックリンク
  65. ├── BOOTSTRAP.md # 初回セットアップ用(セットアップ後に削除されます)
  66. ├── MEMORY.md # 長期記憶(近況・日常メモ・ワークスペース情報)
  67. ├── .claude/
  68. │ └── skills -> ../skills # Claude Code 用シンボリックリンク
  69. ├── .agents/
  70. │ └── skills -> ../skills # Codex CLI 用シンボリックリンク
  71. ├── .grok/
  72. │ └── skills -> ../skills # Grok CLI 用シンボリックリンク
  73. ├── memory/ # 日記・メモの保存先(YYYYMMDD.md 形式)
  74. ├── notes/ # ノート・調査メモの保存先
  75. └── skills/ # スキル(AIの拡張機能) — 一覧は skills/README.md を参照
  76. ```
  77. ## 使い方のヒント
  78. ### メモを取る
  79. ```
  80. 「調査結果をまとめて」
  81. 「会議メモを保存して」
  82. 「最近のメモ教えて」
  83. ```
  84. ### 日記を書く
  85. ```
  86. 「今日の日記を書いて」
  87. 「日記の時間」
  88. ```
  89. ### 猫日記をつける
  90. ペット写真を記録したい場合のサンプルスキルです。不要なら `skills/xs-cat-diary/` を削除して構いません。
  91. ```
  92. [猫の画像を送信]
  93. → 自動で猫を検出してNotionに記録
  94. 「今週の猫ベストショット」
  95. ```
  96. ### プレゼン資料を作る
  97. ```
  98. 「AIの歴史について5枚のスライドを作って」
  99. 「このメモからプレゼン資料を作って」
  100. ```
  101. ### arXiv論文を調べる
  102. ```
  103. 「LLMエージェントの最新論文を探して」
  104. 「この1週間のAIトレンド論文を教えて」
  105. 「論文 2401.12345 を詳しく分析して」
  106. ```
  107. ### PRをレビューする
  108. ```
  109. 「PR#123をレビューして」
  110. 「owner/repo の PR#45 をコードレビューして」
  111. ```
  112. ### GitHubリポジトリを分析する
  113. ```
  114. 「このリポジトリ分析して: owner/repo」
  115. 「https://github.com/owner/repo を見て」
  116. ```
  117. ### ポッドキャストを聴く
  118. ```
  119. 「ポッドキャストの最新回をまとめて」
  120. ```
  121. ### テックニュースをチェック
  122. ```
  123. 「今日のテックニュースを教えて」
  124. ```
  125. ### Gmailをチェックする
  126. ```
  127. 「メールチェックして」
  128. 「未読メール見せて」
  129. 「Driveのファイル一覧」
  130. ```
  131. ### カレンダーを確認する
  132. ```
  133. 「今日の予定」
  134. 「今週のスケジュール確認」
  135. ```
  136. ### 健康管理
  137. ```
  138. 「食事を記録して: ラーメン」
  139. 「今週の健康レポート」
  140. ```
  141. ### マルチAIで考える・レビューする
  142. ```
  143. 「みんなで考えて: ○○のアーキテクチャ」
  144. 「複数のAIでこのPRをレビューして」
  145. ```
  146. ### アイデアを出す
  147. ```
  148. 「アイデア出して: 次のブログのネタ」
  149. 「過去の記事と最近のメモをつないで」
  150. ```
  151. ### 図表を作る
  152. ```
  153. 「アーキテクチャ図描いて」
  154. 「フローチャートにして」
  155. ```
  156. ### 自分だけのスキルを作る
  157. ```
  158. 「読書メモを管理するスキルを作って」
  159. ```
  160. ## カスタマイズ
  161. ### AIの性格を変える
  162. `AGENTS.md` の「自分について」セクションを編集すると、AIの話し方や性格を変えられます。
  163. ### 記憶の残し方を変える
  164. - 長期的に残す情報は `MEMORY.md`
  165. - 日々の生ログは `memory/YYYYMMDD.md`
  166. - 調査結果や記事化したい内容は `notes/`
  167. - 手順や行動ルールは `AGENTS.md`
  168. この分け方を守ると、後からファイル検索やxangi-searchを使う時に「ルール」「長期記憶」「作業ログ」「成果物」が混ざりにくくなります。
  169. ### スキルを追加する
  170. `skills/` ディレクトリにフォルダを作り、`SKILL.md` を書くだけで新しいスキルを追加できます。詳しくは `skills/README.md` を参照してください。
  171. ### 自分用に安全ルールを足す
  172. メール送信、SNS投稿、公開リポジトリへのpush、GitHub Release作成など、外部に影響する操作は `AGENTS.md` に確認ルールを書いておくことを推奨します。内部ファイルの読み取り・整理は大胆に、外部への送信や公開操作は慎重に、という分離が運用しやすいです。
  173. ## ライセンス
  174. MIT License

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.