Inkeep

AIエージェントが読む知識を、Markdown形式のOKF v0.2に沿って整えます。文書の種類、出典、確認履歴、索引や更新ログの扱いを案内します。

• 知識集をOKF形式に整えたいとき
• 出典と確認履歴の記録
• OKFプラグインの警告確認

採用済みの提案を実装仕様書にまとめます。現行システムの調査を土台に、対象範囲、設計の判断理由、未解決事項、移行・テスト計画を整理するスキルです。

• 採用済みの提案を仕様書にしたいとき
• 設計判断と未解決事項の記録
• 移行手順とテスト範囲の整理

繰り返す作業の手順を、AIエージェント用のSKILL.mdにまとめます。既存スキルとの重複確認から、呼び出し条件の設計、動作評価、エディターへの配置まで案内します。

• 定型作業をスキル化したいとき
• 既存スキルの呼び出し条件の改善
• エージェントの手順遵守を評価

登場人物・舞台・勢力・歴史などを相互につながる設定資料として整理します。新しく登場した名前の仮ページを作り、物語と設定の矛盾を指摘するスキルです。

• 人物と舞台の設定資料を整理したいとき
• 章やセッション記録の新しい名前を拾いたいとき
• 世界設定の矛盾を確認したいとき

障害の影響と経緯を証拠に沿って整理し、個人を責めずに原因や検知の遅れを分析。担当・期限・完了条件を備えた再発防止策までまとめるスキル。

• ログを根拠に障害報告を残したいとき
• 障害の発端と根本原因の整理
• 繰り返す障害と過去の対策の照合

アイデアの記録から下書き、レビュー、公開済み原稿の管理までを3段階で整理。滞留した原稿の見直しや公開先の提案も支える、短中編の文章向けスキル。

• 思いついた執筆アイデアの記録
• ブログやニュースレターの執筆・改稿
• 滞留したアイデアと下書きの見直し

ソースコードを読み、構成図・処理の流れ・用語集・変更手順を備えたWikiを作成。読者や詳しさを指定でき、コードの差分に応じた更新も進めるスキル。

• コード全体の構成をWiki化したいとき
• 一連の処理を図で説明したいとき
• 内部向け・公開向けの資料作成

人物・企業・概念ごとの情報を、更新する要約と追記式の履歴に整理します。会議メモから関連情報を拾い、前回の会話の確認や次の面談準備に使えるスキルです。

• 人物や企業ごとの情報をまとめたいとき
• 会議メモを相手ごとの履歴に残したいとき
• 面談前に過去の会話を確認したいとき

保存した原資料、調査中の分析、確定した知識を三層に分け、根拠をたどれるナレッジベースを運用します。文書の状態管理や相互リンク、変更ログの残し方を定めます。

• 原資料・調査・確定知識の整理
• 記事から根拠資料をたどりたいとき
• チームの決定後に文書の状態を整理したいとき

思いついたことを話題別のメモや日付別の日記に残し、関連するページをリンクでつなぎます。前日の日記へのリンクや気分・感謝の記録も整えるスキルです。

• 思い付きを話題別のメモに残したいとき
• 朝の予定や夜の振り返りを記録したいとき
• 関連するメモをリンクでつなぎたいとき

ソフトウェア開発の提案・決定記録・実装仕様・障害報告を、共通の文書ルールで整理します。状態の遷移や関連文書の結び方、古い資料の見直し方も案内します。

• 開発プロジェクトの文書整理
• 提案や決定の状態を管理したいとき
• 障害報告と手順書の関連付け

調べたいテーマの資料を原文のまま保存し、根拠付きの調査記事にまとめます。既存調査の確認、比較軸の整理、利点と欠点の比較、未解決の疑問の記録まで扱います。

• 技術やサービスを根拠付きで比較したいとき
• 論文や公式資料をまとめた調査記事の作成
• 既存の調査記事を更新したいとき

設計変更の提案を、誰の何が変わるかという問題設定から組み立て、代替案・欠点・未解決の問いを含む、レビューに出せるRFC形式の草案にまとめます。

• 設計変更のRFC草案作成
• 受益者と確認可能な成果の整理
• 代替案と設計上の欠点の比較

決定済みのシステム設計方針を、背景・比較した選択肢・利点と負担を含む記録にまとめます。過去の決定を置き換える際も、変更の経緯をリンクで残します。

• 設計方針の採用理由を残したいとき
• 決定に伴う負担や責任の記録
• 過去の決定を履歴付きで更新したいとき

提案や仕様が本来の課題を解き、目標と制約に沿う設計になっているかを検討します。過去の決定や失敗も踏まえ、根拠・重要度・解決案を伴う指摘にまとめます。

• 提案が本当の課題を解くか確認したいとき
• 仕様を目標と制約に照らして検討したいとき
• 代替案と長期的な維持費用を比べたいとき

既存の調査ノートを、決定内容と理由が分かる正式な記事へまとめます。元資料を残し、旧記事との置き換え関係や関連ページへのリンクも整えて根拠を追える形にします。

• 調査後の決定を文書化したいとき
• 複数の調査ノートの一本化
• 正式記事と置き換え関係の更新

Markdownを人とAIで共同編集するOpenKnowledgeの導入や共有を案内。単独ファイルのプレビューや、利用環境に応じた開き方も扱うスキル。

• リポジトリにOpenKnowledgeを導入
• 共同作業者へのプロジェクト共有
• 初期化前のMarkdownプレビュー

OpenKnowledge内の文書を検索・編集し、根拠や関連文書をたどれる形に整えます。テンプレートの利用から内部リンクの検証、履歴の確認まで扱います。

• 既存の文書から回答を探したいとき
• テンプレートを使った文書作成・編集
• 内部リンクや記述ルールの検証