← 返回 Skills 市场
brad-sl

Reference Maintainer

作者 brad-sl · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
67
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install reference-maintainer
功能描述
Automation skill for Reference Maintainer.
安全使用建议
This skill appears to be what it says: a documentation generator that parses source files and writes docs. Before installing or running it, review the included scripts (noted issues: reference_updater.py has a hard-coded default target 'sentiment_decay_model.py' and an indentation bug that may break execution). Important cautions: 1) Run it only on copies or non-sensitive repositories — the tool will read source files and persist extracted configuration (which can include secrets) into references/ and a log file. 2) Limit the paths you pass to the tool and inspect generated output before sharing. 3) If you plan to let an agent invoke this skill autonomously, restrict its file-system access to safe directories. If you want, I can point out the exact lines to change to avoid the hard-coded default and to inspect/escape potential secret-like values before writing them.
功能分析
Type: OpenClaw Skill Name: reference-maintainer Version: 1.0.0 The skill bundle is designed as a system documentation generator but explicitly instructs the AI agent to extract and include 'credentials' in the generated reference docs (SKILL.md and references/templates/schema.yaml). While the Python scripts (scripts/universal_doc_generator.py) use standard AST parsing to extract configurations, the directive to harvest secrets and store them in 'living reference docs' for session persistence is a high-risk behavior that facilitates credential harvesting. No explicit exfiltration logic or remote endpoints were identified, suggesting this may be a misguided 'expert memory' feature rather than a targeted attack, but it remains highly irregular and dangerous.
能力评估
Purpose & Capability
Name/description match the included Python scripts and templates. The code implements AST/JSON/YAML extraction and generates Markdown/YAML/JSON documentation as advertised. There are no extraneous credentials, binaries, or network calls that contradict the stated purpose.
Instruction Scope
SKILL.md and the scripts instruct the agent to parse source files and generate documentation. That is in-scope for a documentation generator, but the code will read arbitrary files you point it at (or the default target in reference_updater.py) and persist extracted config data (including anything that looks like credentials) into references/ and doc_generator.log. Review and restrict the files/paths you allow the skill to access to avoid accidental collection/persistence of secrets.
Install Mechanism
No install spec — instruction-only plus included scripts. No packages are downloaded or executed from remote URLs. This minimizes install-time risk.
Credentials
The skill declares no required environment variables, credentials, or config paths. The code also does not read environment variables or request external credentials. However, it can extract and persist data from any file it is pointed at, so secrets in source files could be collected as part of normal operation.
Persistence & Privilege
The skill writes output files under references/ and creates a local log file (doc_generator.log) in the working directory. It does not request persistent agent-level privileges or modify other skills. Consider filesystem write implications before running in sensitive directories.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install reference-maintainer
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /reference-maintainer 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Universal doc generator prevents AI 'new hire syndrome' via auto-updating refs/schemas. Works on any code/system.
元数据
Slug reference-maintainer
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

Reference Maintainer 是什么?

Automation skill for Reference Maintainer. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 67 次。

如何安装 Reference Maintainer?

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

Reference Maintainer 是免费的吗?

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

Reference Maintainer 支持哪些平台?

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

谁开发了 Reference Maintainer?

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

💬 留言讨论