suyuan2022/suyuan-skill

解決する問題

AI エージェントは、読みたくない長文、技術的には正しいが役に立たない一般的な回答、またはクラウドサービスから自分のデータを取り出せないことがよくあります。このプロジェクトは、それらの具体的な不満を解決する 3 つの実用的なスキルを集めています。1 つは難しい概念をシンプルな図に変換し、1 つは AI に回答前に専門家のように考えさせ、もう 1 つは Get Notes（biji.com）のデータを自分のコンピュータに移行します。

仕組み

各スキルは、トリガーされたときにエージェントが読み取る一連の指示です。npx skills add suyuan2022/suyuan-skill -g のようなコマンドでインストールすると、ユーザーディレクトリに配置され、すべてのプロジェクトで機能します。3 つすべてをインストールすることも、1 つだけ選ぶこともできます。エージェントがタスクを開始するたびに、インストールされているすべてのスキルの説明を読み取るため、作成者はエージェントの注意を無駄にしないように、実際に使用するものだけをインストールすることを推奨しています。

• whatis – 概念が理解できない場合やエージェントのテキストが長すぎる場合に呼び出します（例：/whatis 美联储加息为什么会让房贷变贵）。テキストは最小限で、図（フローチャート、シーケンス図、アーキテクチャ図、前後比較）が中心の単一の HTML ページを生成します。コンテキストが不十分な場合は、まずファイルやウェブを検索し、図の各ボックスは証拠に基づいている必要があります。捏造された事実はありません。Anthropic の ELI5 アイデアを基に、より信頼性の高い出力のためにタイポグラフィと構造要件を追加したものです。
• break-ai-slop – オープンエンドなタスクを開始する前に、エージェントに 4 つの質問に答えさせます。現実世界で誰がこれを最も得意とし、どのような状況か？初心者や AI の失敗した結果はどのようなものか？一般的な間違いを避けてもまだ間違っている場合、根本的な問題は何か？成功を本当に決定する制約は何か？これらを考えた後にのみ開始します。「これは使い捨てではない、最初に慎重に考えて」と言うか、/break-ai-slop を使用してトリガーできます。これは、事実やタイプミスではなく、執筆、計画、判断タスクを対象としており、出力は 2 倍の長さになります。
• get-biji – Get Notes（biji.com）ユーザー向け。すべての録音、保存したリンク、クイックノートを日付で整理されたローカル Markdown ファイルに同期します。新しい項目は増分で取得できます。文字起こしには話者とタイムスタンプが含まれ、長いものは独自のファイルになります。ファイルはあなたのものなので、エージェントは他のノートと一緒に検索でき、Get が変更されたりオフラインになっても保持されます。また、Get の無料文字起こし枠を使用します。抖音、小红书、Bilibili、小宇宙のリンクを貼り付けると、Get がテキストに解析します。他のサイトやローカルオーディオの場合は、Get にアップロードすると月間枠から差し引かれます（エージェントが事前におおよそのコストを伝えます）。文字起こしは一時的な Get ノート内で行われ、スキルはその後そのノートを削除するため、他のノートには影響しません。セットアップには npm install && npx playwright install chromium の実行が必要です（約 250MB のダウンロード、ログインのみに使用）。初回使用時にブラウザが開いて biji.com にログインするため、自分のコンピュータで実行する必要があります。その後、約 90 日間ログイン状態が維持されます。ローカルオーディオ/ビデオの変換には ffmpeg も必要です。ノートは指定したディレクトリに保存され、ログイン状態は ~/.config/get-biji/ にあり、再インストールやアップデート後も保持されます。このスキルは skychentian/GET-biji を作者の許可を得て基にしています。同期部分はオリジナルから、文字起こしスクリプトは追加されました。

対象読者

実際の作業に AI エージェント（Claude Code など）を使用し、次のような一般的な不満に直面している人向け：概念が理解できない、平凡な一般的な出力が得られる、ノートアプリに閉じ込められたデータを所有して再利用したい。スキルはグローバルにインストールされるため、エージェントが扱う任意のプロジェクトで機能します。

ハイライト

• 図優先の説明 – whatis は概念を最小限のテキストで視覚的な HTML ページとしてレンダリングし、トピックに最適な図タイプを選択します。
• 証拠に基づく図 – 各ボックスは正当化される必要があり、必要に応じてエージェントはファイルやウェブをチェックします。
• スロップ防止思考ルーチン – break-ai-slop の 4 つの質問により、エージェントは行動前に現実世界のコンテキスト、失敗モード、根本原因、真の制約を考慮します。
• Get Notes のローカル所有権 – 話者タグ付き文字起こし、増分更新、オフラインアクセスを備えた Markdown への完全エクスポート。
• 追加ツールなしの文字起こし – Get 自身の枠を使用してリンクやアップロードを変換し、事前にコストを警告します。
• プロジェクト横断で動作 – グローバルインストールにより、エージェントが触れる任意のプロジェクトでこれらのスキルを使用できます。
• MIT ライセンス – 無料で使用・変更可能。