← 返回 Skills 市场
Roadmap Communicator
作者
Alireza Rezvani
· GitHub ↗
· v2.1.1
· MIT-0
332
总下载
0
收藏
6
当前安装
2
版本数
在 OpenClaw 中安装
/install roadmap-communicator
功能描述
Use when preparing roadmap narratives, release notes, changelogs, or stakeholder updates tailored for executives, engineering teams, and customers.
安全使用建议
This skill appears coherent and limited in scope, but exercise normal caution before enabling code from an unknown author: 1) The included script reads your git commit messages — those can contain sensitive info, so review the output before sharing externally. 2) Inspect scripts locally (you can read scripts/changelog_generator.py, which is small and clear) and run them in a trusted environment. 3) Ensure git and python3 are present and that you run the script in the intended repository or with --stdin/--demo to avoid exposing unrelated commit history. If you need provenance, ask the publisher for a homepage or source repository before broad deployment.
功能分析
Type: OpenClaw Skill
Name: roadmap-communicator
Version: 2.1.1
thought
The user wants me to analyze an OpenClaw AgentSkills skill bundle (ZIP content provided as text).
I need to classify it as `benign`, `suspicious`, or `malicious` based on specific criteria:
- Data exfiltration
- Malicious execution
- Persistence/backdoors
- Prompt injection against the agent
- Obfuscation
- Supply chain issues
I must distinguish between vulnerabilities (suspicious) and intentional malice (malicious).
Files provided:
1. `_meta.json`: Metadata about the skill.
2. `SKILL.md`: Instructions for the AI agent.
3. `scripts/changelog_generator.py`: A Python script to generate changelogs from git.
4. `references/communication-templates.md`: Markdown templates for communication.
5. `references/roadmap-templates.md`: Markdown templates for roadmaps.
- `ownerId`, `slug` ("roadmap-communicator"), `version` ("2.1.1"), `publishedAt`.
- Looks standard.
- Describes the skill: preparing roadmap narratives, release notes, etc.
- Provides guidance on roadmap formats and stakeholder updates.
- Mentions a script: `python3 scripts/changelog_generator.py --from v1.0.0 --to HEAD`.
- Includes a quality checklist.
- No obvious prompt injection or instructions to exfiltrate data or perform unauthorized actions.
- Purpose: Generate changelog sections from git log or piped input.
- `SECTIONS`: Standard conventional commit types.
- `DEMO_COMMITS`: Hardcoded sample data.
- `get_git_log` function:
- Uses `shutil.which("git")` to check for git.
- Uses `subprocess.run(["git", "log", "--pretty=format:%s", commit_range], ...)` to get commit messages.
- `commit_range` is constructed from `args.from_ref` and `args.to_ref`.
- **Vulnerability Check**: `commit_range = f"{from_ref}..{to_ref}"`. If `from_ref` or `to_ref` contains shell metacharacters, could there be an injection?
- `subprocess.run` is called with a list: `["git", "log", "--pretty=format:%s", commit_range]`. Since it's a list and `shell=True` is NOT set, shell injection via the arguments is generally mitigated by the OS/Python's handling of the argument list. However, `git` itself might interpret certain flags if the input starts with `-`.
- The script uses `argparse` which helps define expected inputs.
- `read_stdin`, `group_commits`, `render_markdown`, `render_text`: Standard logic for processing strings.
- No network calls, no file writing (only printing to stdout), no reading of sensitive files (only git log).
- Standard templates for emails and release notes.
- No executable code or suspicious instructions.
- Standard templates for roadmaps.
- No executable code or suspicious instructions.
- The skill is a tool for product managers/engineers to generate roadmap and changelog artifacts.
- The Python script is a utility for parsing git logs.
- The use of `subprocess.run` with a list is safe against shell injection.
- There is no evidence of data exfiltration, persistence, or malicious intent.
- The instructions in `SKILL.md` are aligned with the stated purpose.
Classification: `benign`.
```json
{
"classification": "benign",
"summary": "The roadmap-communicator skill is a legitimate tool for generating product management artifacts like roadmaps and changelogs. The included Python script (scripts/changelog_generator.py) safely uses subprocess.run with an argument list to interface with git, and the SKILL.md instructions are strictly aligned with the stated purpose without any signs of prompt injection or malicious intent."
}
```
能力评估
Purpose & Capability
The name/description (roadmap, release notes, changelogs) align with the included templates and a changelog generator script. There are no unrelated binaries, environment variables, or config paths requested. Source/homepage are missing (author unknown), but that doesn't make the capability inconsistent.
Instruction Scope
SKILL.md instructs the agent to produce communication artifacts and optionally run the provided changelog_generator.py to read git commit messages. The script only reads git commit subjects (or stdin/demo) and formats them; it does not access other files, environment variables, or external endpoints.
Install Mechanism
No install spec; this is instruction-only with an included Python script. No downloads or extracted archives. The script is runnable with system Python and expects git on PATH if used.
Credentials
No required environment variables, credentials, or config paths are declared or used. The only runtime dependency is git (checked at runtime) and python3, which are appropriate for the stated functionality.
Persistence & Privilege
always is false and the skill does not request permanent or system-wide changes. There is no code that modifies other skills or agent configuration.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install roadmap-communicator - 安装完成后,直接呼叫该 Skill 的名称或使用
/roadmap-communicator触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v2.1.1
v2.1.1: optimization, reference splits
v1.0.0
Initial publish
元数据
常见问题
Roadmap Communicator 是什么?
Use when preparing roadmap narratives, release notes, changelogs, or stakeholder updates tailored for executives, engineering teams, and customers. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 332 次。
如何安装 Roadmap Communicator?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install roadmap-communicator」即可一键安装,无需额外配置。
Roadmap Communicator 是免费的吗?
是的,Roadmap Communicator 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Roadmap Communicator 支持哪些平台?
Roadmap Communicator 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Roadmap Communicator?
由 Alireza Rezvani(@alirezarezvani)开发并维护,当前版本 v2.1.1。
推荐 Skills