← 返回 Skills 市场
rawc0der

Spec to ADR

作者 rawc0der · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ 安全检测通过
76
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install spec-to-adr
功能描述
Convert agent execution plans into MADR-format Architecture Decision Records for audit trails and architecture progression. Use when the user asks to create...
安全使用建议
This skill appears coherent and limited to creating ADR files from plans in your repository. Before installing or invoking it, consider: (1) Are you comfortable allowing the agent to read project files and write into your repo workspace? (2) Prefer running it in a branch or sandbox so generated ADRs can be reviewed before committing. (3) The tool may run git-config lookups for the user.name to populate fields—no credentials are required. (4) If your project uses a different ADR location or naming convention, confirm or provide that to the agent to avoid unexpected file writes. Finally, review any generated ADR and updated README.md before merging to ensure accuracy.
功能分析
Type: OpenClaw Skill Name: spec-to-adr Version: 1.0.0 The 'spec-to-adr' skill is a utility designed to automate the conversion of project execution plans into Architecture Decision Records (ADRs) using the MADR format. It involves reading local markdown files (e.g., from `.planning/` or `.cursor/plans/`), extracting structured data, and writing new files to a `docs/adr/` directory. While it performs file system operations and executes a single benign command (`git config user.name`) to identify decision-makers, its behavior is entirely consistent with its stated purpose and lacks any indicators of malicious intent, data exfiltration, or unauthorized persistence.
能力评估
Purpose & Capability
Name and description match the instructions: the skill locates plan files in the workspace, extracts decision content, generates ADR markdown, and updates an ADR index. No unrelated credentials, binaries, or external services are requested.
Instruction Scope
Runtime instructions operate on repository files (e.g., .planning/, .cursor/plans/, generic markdown, docs/adr/). They direct reading source plan files and writing ADR files and an index. The scope is limited to documentation/architecture artifacts and includes sensible edge-case handling (multiple decisions, superseding ADRs). The instructions do not direct data to external endpoints or request reading unrelated system secrets.
Install Mechanism
This is an instruction-only skill with no install spec and no code files to execute. That minimizes disk/installation risk.
Credentials
The skill declares no required environment variables or credentials. It suggests using the git user name (git config user.name) as a convenience, which is proportional to populating 'Decision-makers'. No secrets or unrelated tokens are requested.
Persistence & Privilege
The skill does not request always: true and does not modify other skills or global agent settings. It writes ADR files into the repository workspace (docs/adr/ or equivalent), which is appropriate for its function; persistent presence is not requested.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install spec-to-adr
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /spec-to-adr 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
- Initial release: Convert execution plans into numbered MADR-format Architecture Decision Records (ADRs) for audit trails and architecture documentation. - Supports detection and extraction from GSD phase plans, Cursor CreatePlan output, and generic markdown plans. - Automates mapping plan content to MADR fields, handling various sources and inferring fields as needed. - Generates and numbers ADR files using a standardized filename format and manages the ADR directory structure. - Updates and maintains an index of all ADRs in `README.md`. - Handles multi-decision plans, ADR superseding, sparse plans, and directory creation according to best practices.
元数据
Slug spec-to-adr
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

Spec to ADR 是什么?

Convert agent execution plans into MADR-format Architecture Decision Records for audit trails and architecture progression. Use when the user asks to create... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 76 次。

如何安装 Spec to ADR?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install spec-to-adr」即可一键安装,无需额外配置。

Spec to ADR 是免费的吗?

是的,Spec to ADR 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Spec to ADR 支持哪些平台?

Spec to ADR 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Spec to ADR?

由 rawc0der(@rawc0der)开发并维护,当前版本 v1.0.0。

💬 留言讨论