mcpField
L
lens-brief

lens-brief

github.com/venhdevその他111 回インストール今日更新
リポジトリ

lens-brief について

lens-briefは、リポジトリのシンボルやパスに基づいて平易な技術要約を作成するスキルです。結論を先に示し、簡潔な能動表現を使い、分析範囲を限定します。

主な機能

  1. 01結論を先に示すBLUF構成
  2. 02平易で簡潔な能動表現の規則
  3. 03リポジトリのシンボルとパスを明記
  4. 04ファイルを変更せず文脈を分離

活用シーン

  1. 01技術的な問題をレビュー向けに要約
  2. 02具体的なコード参照でリポジトリの動作を説明

インストール

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

$npx skills add https://github.com/venhdev/skills --skill lens-brief

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

詳細

lens-brief — 平易な言葉で技術概要を作成する制御エンジン

運用上の不変条件

  • 言語への適応：呼び出し元が現在使用している会話言語（例：ベトナム語、英語）で応答します。
  • BLUF の優先：決定的な結論または回答を、冒頭の文で述べます。
  • 平易な表現（ASD-STE100）：能動態と短い文（最大 20～25 語）を使います。余分な語句、句動詞、受動的な表現は避けます。
  • コードへの紐付け：曖昧な代名詞ではなく、用語を具体的なリポジトリ内のシンボルと相対パス（file_path、SymbolName）に直接紐付けます。
  • コンテキストの分離：ファイルを変更したり、現在のスコープを広げたりせず、独立して説明します。

分野別基準

1. 平易な言葉への変換マトリックス（ISO 24495-1）
  • 見つけやすさ：BLUF の引用ブロックで決定的な要点を最初に示し、核心となるメッセージをすぐに見つけられるようにします。
  • 理解しやすさ：官僚的な言い回しや名詞化を避け、明確で意味が一つに定まる言葉を使った能動態の文にします。
  • 使いやすさ：具体的な要点または実行すべき操作を、文脈の中で直接示します。
2. 言葉選びの指針（好ましくない表現と改善例）
  • 好ましくない表現（英語）：「認証パイプラインの非同期リファクタリングを実施することを決定しました。」
  • 改善例：AuthService を 2 つのバックグラウンドタスクに分割します。これにより、ログインのタイムアウトを防ぎます。
  • 好ましくない表現（ベトナム語）：「認証フローの非同期リファクタリングを実施しました。」
  • 改善例：システムは AuthService を 2 つのバックグラウンドタスクに分割し、ログインのタイムアウトを防ぎます。

標準出力仕様

> **BLUF**: <Single active sentence stating the core conclusion, change, or answer. Max 20 words.>

<1–3 short paragraphs in plain natural prose. Max 25 words per descriptive sentence, 20 words per procedural sentence. Use active voice and ubiquitous symbols. Explain the context, mechanics, or consequence directly.>

*(omit if purely informational)*
**Next Step**: <Concrete command to execute or decisive choice required from caller.>

コメント

Markdown 対応