mcpField
L
lens-brief

lens-brief

github.com/venhdev其他111 次安装今天更新
代码仓库

关于 lens-brief

lens-brief 是用于撰写通俗技术摘要的 Skill，以仓库符号和路径为依据。它强调先给结论、使用简洁主动的表达，并限制分析范围。

主要功能

  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 — 受控的通俗技术摘要引擎

运行约束

  • 语言适配：使用调用者当前的对话语言作答（例如，越南语、英语）。
  • 结论优先：在开头第一句说明关键结论或答案。
  • 通俗表达（ASD-STE100）：使用主动语态和短句（最多 20–25 个词）；删去填充词、短语动词和被动表达。
  • 代码锚定：将术语直接关联到具体的代码库符号和相对路径（file_path、SymbolName），不要使用含糊的代词。
  • 上下文隔离：独立解释，不修改文件，也不扩大当前范围。

领域准则

1. 通俗语言转换矩阵（ISO 24495-1）
  • 易于查找：在 BLUF 引用块中先给出关键结论，让读者立即找到核心信息。
  • 易于理解：使用含义明确的词语和主动句，避免官僚式表达和名词化表达。
  • 易于使用：直接在上下文中说明具体结论或操作步骤。
2. 措辞指南（问题 vs. 改进方案）
  • 问题（英语）：“我们决定对身份验证流程进行异步重构。”
  • 改进方案：“我们将 AuthService 拆分为两个后台任务。这可以防止登录超时。”
  • 问题（越南语）：“Chúng tôi đã tiến hành triển khai thực hiện việc tái cấu trúc bất đồng bộ đối với luồng xác thực.”
  • 改进方案：“Hệ thống tách AuthService thành hai tác vụ nền để ngăn lỗi timeout đăng nhập.”

标准输出约定

> **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