← 返回 Skills 市场
Write Adr
作者
Kevin Anderson
· GitHub ↗
· v1.1.2
· MIT-0
148
总下载
0
收藏
1
当前安装
2
版本数
在 OpenClaw 中安装
/install write-adr
功能描述
Use when you want to generate Architecture Decision Records from this session. Triggers on "write ADRs", "document our decisions", "create decision records",...
安全使用建议
This skill appears to do what it says: it scans your repo, extracts decisions from the session via subagents, asks you which to document, and writes MADR-formatted ADR markdown files. Before enabling or running it: 1) Confirm the repository contains the expected helper script (skills/adr-writing/scripts/next_adr_number.py) and the target directory (note the SKILL.md inconsistently references docs/adrs/ and docs/adr/), or it may fail or write files to an unexpected location. 2) Be aware subagents will read your repository files (commits, code) to collect context and will create files under docs/adr/ — review generated files before committing/pushing. 3) Verify you trust the referenced subskills (beagle-analysis:adr-decision-extraction and beagle-analysis:adr-writing) because this skill delegates model-driven work to them. 4) The skill does not request credentials or install external code, which reduces risk, but exercise the usual caution when allowing any skill to read and write your repository.
功能分析
Type: OpenClaw Skill
Name: write-adr
Version: 1.1.2
The skill is a legitimate tool for automating the generation of Architecture Decision Records (ADRs). It uses standard read-only commands (git, ls, find) to gather context and orchestrates subagents to extract and write documentation to the local 'docs/adr/' directory, following a clear workflow with user confirmation steps (SKILL.md).
能力评估
Purpose & Capability
The name/description matches the actions in SKILL.md: it scans repository context, extracts decisions, asks the user to confirm, and writes ADR files. Required binaries/credentials are none, which is coherent for a repo-local ADR generator.
Instruction Scope
Instructions intentionally read repository state (git branch, recent commits, ls/find of docs directories) and write ADR files under docs/adr/ (and refer to docs/adrs/ elsewhere). This file I/O is expected for the purpose, but there is an inconsistency in directory naming (docs/adrs/ vs docs/adr/) and a dependency on a repository-local script (skills/adr-writing/scripts/next_adr_number.py) that may not exist. The skill also asks subagents to "explore the codebase," which is within scope but means the subagents will read project files for context.
Install Mechanism
No install spec or external downloads — instruction-only — so nothing is written to disk by an installer and no third-party packages are pulled by the skill itself.
Credentials
The skill declares no required environment variables or credentials, which is appropriate. It does reference loading other skills (beagle-analysis:adr-decision-extraction and adr-writing); you should verify you trust those subskills.
Persistence & Privilege
The skill is not always-enabled and requests no elevated agent privileges. It sets disable-model-invocation: true for itself while instructing the agent to launch subagents that do model work — this is a design choice (not a direct risk), but it means the skill relies on other skills/subagents to perform model-driven steps. The skill will write files into the repository (docs/adr/), so expect persistent changes to project files.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install write-adr - 安装完成后，直接呼叫该 Skill 的名称或使用
/write-adr触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.1.2
**Expanded skill description, clarifies triggers and boundaries.**
- Skill description now details phrases that trigger execution and differentiates from related skills (adr-decision-extraction, adr-writing).
- Emphasizes orchestration of the end-to-end workflow: decision extraction, user confirmation, parallel ADR generation, and verification.
- Makes clear that this skill does not handle extraction alone or MADR template output.
- No workflow logic was changed—documentation only.
v1.1.1
**Improvements to ADR Generation Workflow**
- Enhanced decision extraction by analyzing session conversations with a dedicated subagent and presenting full details for user selection.
- Introduced user confirmation step: display comprehensive decision info and allow selective ADR creation (by number, "all", or "none").
- Refactored ADR number allocation: numbers are pre-assigned to decisions before subagents are launched in parallel, eliminating duplicate numbering.
- Standardized post-generation reporting and verification, including a checklist to ensure completeness and adherence to MADR format.
- Added instructions for ADR output location, initial template creation, and user follow-up for incomplete records.
元数据
常见问题
Write Adr 是什么？
Use when you want to generate Architecture Decision Records from this session. Triggers on "write ADRs", "document our decisions", "create decision records",... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 148 次。
如何安装 Write Adr？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install write-adr」即可一键安装，无需额外配置。
Write Adr 是免费的吗？
是的，Write Adr 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Write Adr 支持哪些平台？
Write Adr 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Write Adr？
由 Kevin Anderson（@anderskev）开发并维护，当前版本 v1.1.2。
推荐 Skills