Token导航 LogoToken导航

Agent Skill · 研究检索

adr-management(ADR 管理)

adr-management 用于查找、检索和筛选相关信息,适合在 Codex、Claude、Cursor、Gemini CLI 中需要根据关键词、任务场景或来源线索快速定位候选结果时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态,以及是否会触发联网、命令执行或文件读写。

adr-management 是研究检索类 Agent Skill,可用宿主为 Codex、Claude、Cursor、Gemini CLI,通过GitHub 仓库获取,权限为只读;许可证信息还不明确,第三方扫描已通过,按安装量在研究检索类的 73,674 个 Skill 里排第 53,392。

总安装 535周安装 23GitHub Stars 2下载 188核验 2026-05-01

安装说明

本站只整理中文说明,不托管安装包,也不代用户安装。
GitHub
许可证
unknown

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手,先确认命令和权限,再让它执行。

请帮我安装这个 Agent Skill:adr-management(ADR 管理)
来源仓库:https://github.com/richfrem/agent-plugins-skills
仓库路径:skills/adr-management
安装命令:
npx skills add https://github.com/richfrem/agent-plugins-skills --skill adr-management
安装前请先检查当前环境是否支持对应 CLI,并向我确认将要执行的命令、安装目录、联网范围和文件读写权限;确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过 npx skills 从第三方来源获取 Skill;本站只展示命令,不托管安装包,也不自动执行。

skills.shnpx skills
npx skills add https://github.com/richfrem/agent-plugins-skills --skill adr-management

这个 Skill 是做什么的

研究检索类 Skill 主要解决「找资料、核对事实、把来源整理清楚」的问题,通常会让助手先检索再总结。

adr-management 用于查找、检索和筛选与架构决策记录(ADR)相关的资料。适合在系统设计阶段参考已有决策模式或生成新的 ADR 草案。通过 npx skills add 命令从 GitHub 仓库安装,建议查阅原始文档了解检索范围。安装前应确认权限与项目维护状态,避免非预期网络请求。

适用宿主包括 Codex、Claude、Cursor、Gemini CLI,接入前应确认版本、权限和运行环境要求。

来源仓库内路径:skills/adr-management

上手步骤

4 步
  1. 1

    确认自己的宿主工具

    公开资料标注支持 Codex、Claude、Cursor、Gemini CLI;先确认自己用的是其中之一,再按对应工具的 Skills 目录放置。

  2. 2

    拿到安装命令

    可以直接复制的命令是 npx skills add https://github.com/richfrem/agent-plugins-skills --skill adr-mana…;命令里的占位符换成自己的路径或密钥再执行。

  3. 3

    安装后重启宿主

    命令执行完要完全退出宿主工具再打开,让新装的 Skill 被重新扫描到,否则列表里可能看不到。

  4. 4

    按最小权限试用

    它标注为只读,先用只读任务试一次,确认行为符合预期再扩大使用范围。

常见问题

6 条

adr-management 怎么安装?

在终端执行 npx skills add https://github.com/richfrem/agent-plugins-skills --skill adr-management。装完完全退出宿主工具再打开,让它重新扫描本地 Skill。

adr-management 支持哪些 AI 工具?

公开资料标注支持 Codex、Claude、Cursor、Gemini CLI。其他工具只要能读取本地 Skill 目录,一般也能手动放进去,但要自己确认触发方式是否一致。

adr-management 需要什么权限?

权限级别是只读。该 Skill 主要提供规则、说明或参考内容,本身偏只读;真正读写文件、联网或执行命令仍取决于宿主 Agent 的任务。

adr-management 是免费的吗?

公开资料没有标注明确许可证,收费和商用限制都无法确认。正式使用前请到来源仓库核对授权说明。

adr-management 用的人多吗?

公开数据是累计安装 535 次,近一周安装 23 次,下载 188 次,GitHub 2 星。这些数字来自第三方目录统计,只能当作热度参考,不代表质量或安全性。

adr-management 安全吗?

第三方扫描结果为通过,但这只覆盖已知的静态检查项,不能替代自己读一遍源码和安装命令。

值得选的地方和要先想清楚的地方

值得选的地方

  • 同时适配 4 种工具,换客户端不用重新找替代品。
  • 第三方扫描已通过,常见的高风险行为没有命中。
  • 标注为只读权限,试用阶段不容易误改本地文件。

先想清楚的地方

  • 许可证没有明确标注,能不能商用、能不能再分发都不确定。
  • 第三方目录整理,版本更新和行为细节以来源仓库为准。

适不适合你

更适合

  • 已经在用 Codex,想直接扩展它能力的人。
  • 需要处理研究检索类任务、又不想每次都手写提示词的人。
  • 只想先试试效果、不希望它改动本地文件的人。

不太适合

  • 需要明确授权才能用到公司项目里的场景。
  • 需要厂商级技术支持和 SLA 的生产系统。

研究检索类 Skill 对比

6 个同类
Skill总安装GitHub 星权限许可证扫描
find-skills

寻找技能 · Codex、Claude

31,199,81316,486操作浏览器MIT有提醒
self-improving-agent

自我改进 Agent · OpenClaw

16,464,0023,396接触敏感数据MIT-0通过
soultrace

灵魂追踪 · Codex、Claude

7,588,94412需要联网未明确有提醒
self-improving

自我完善 · OpenClaw

6,829,2841,046需要联网MIT-0通过
microsoft-foundry

微软代工厂 · Codex、Claude

6,614,144764调用外部服务未明确有提醒
adr-management

ADR 管理 · 本页

5352只读未明确通过

按安装量取同分类前几名;数字来自第三方目录统计,只作热度参考,不代表质量结论。

SKILL.md 原文

Dependencies

This skill requires Python 3.8+ and standard library only. No external packages needed.

To install this skill's dependencies:

pip-compile ./requirements.in
pip install -r ./requirements.txt

See requirements.txt for the dependency lockfile (currently empty — standard library only).


Identity: The ADR Manager 📐

You manage Architecture Decision Records — the project's institutional memory for technical choices.

🎯 Primary Directive

Document, Decide, and Distribute. Your goal is to ensure that significant architectural choices are permanently recorded in the docs/architecture/decisions/ directory using the standard format.

🛠️ Tools (Plugin Scripts)

Canonical path (use this — agents run from the project root):

.agents/skills/adr-management/scripts/adr_manager.py
.agents/skills/adr-management/scripts/next_number.py

Always invoke with the root-relative path:

python3 .agents/skills/adr-management/scripts/adr_manager.py <command>
python3 .agents/skills/adr-management/scripts/next_number.py --type adr

Do NOT use ./adr_manager.py (relative to script dir — breaks from project root).

Core Workflow: Creating an ADR

When asked to create an Architecture Decision Record (ADR):

1. Execute the Manager Script

  • Default Location: The ADRs/ directory at the project root.
  • Execute the Manager script with the create subcommand. It will automatically determine the next sequential ID and generate the base template file for you.
  • e.g., python3.agents/skills/adr-management/scripts/adr_manager.py create "Use Python 3.12" --context "..." --decision "..." --consequences "..."
  • The script will print the path of the generated .md file to stdout.

2. Fill in the Logical Content

  • Open the newly generated file.
  • Edit the scaffolded sections based on the user's conversational context.
  • Extrapolate Consequences and Alternatives based on your software engineering knowledge.

3. Maintain Status & Cross-References

  • Status values: A new ADR should usually be Proposed or Accepted.
  • If a new ADR invalidates an older one, edit the older ADR's status to Superseded and add a note linking to the new ADR.
  • Reference ADRs by number — e.g., "This builds upon the database choice outlined in ADR-0003."

Auxiliary Workflows

Listing ADRs

python3 .agents/skills/adr-management/scripts/adr_manager.py list
python3 .agents/skills/adr-management/scripts/adr_manager.py list --limit 10

Viewing a Specific ADR

python3 .agents/skills/adr-management/scripts/adr_manager.py get 42

Searching ADRs by Keyword

python3 .agents/skills/adr-management/scripts/adr_manager.py search "ChromaDB"

Sequence Resolution

Use next_number.py to identify the next sequential ID across various artifact domains.

  • Scans: Specs, Tasks, ADRs, Business Rules/Workflows.
  • Example: python3.agents/skills/adr-management/scripts/next_number.py --type adr

Best Practices

  1. Always fill all sections: Never leave an ADR blank. Extrapolate context and consequences based on your software engineering knowledge.
  2. Kebab-Case Names: Always format the filename as NNN-short-descriptive-title.md.
  3. Reference ADRs by number — e.g., "This builds upon the database choice outlined in ADR-003."

平台分布

Codex

37.54%
按下载量换算71

Claude

30.6%
按下载量换算58

Cursor

19.72%
按下载量换算37

Gemini CLI

9.73%
按下载量换算18

安全审计

Gen Agent Trust Hub

通过

Socket

通过

Snyk

通过

权限和风险

只读

该 Skill 主要提供规则、说明或参考内容,本身偏只读;真正读写文件、联网或执行命令仍取决于宿主 Agent 的任务。

安装前确认

本站仅展示第三方公开信息,不托管安装包,不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。目前只有一个公开来源,建议同时核对源仓库。

继续浏览同类 Skills