← 返回 Skills 市场
Opencode Guide
作者
wangning823-arch
· GitHub ↗
· v1.0.0
· MIT-0
103
总下载
0
收藏
1
当前安装
1
版本数
在 OpenClaw 中安装
/install opencode-guide
功能描述
协调并转达用户需求给 opencode 执行代码分析和修改,确保确认后异步使用自动回调脚本执行并汇报结果。
安全使用建议
Before installing:
- Expect the package to copy scripts into your home (~/.openclaw/scripts) during install. Review those scripts first.
- The scripts expect an 'opencode' CLI and utilities (timeout, grep, sed); SKILL.md also suggests using jq to read sessions.json. The package metadata does not declare these — ensure you have them installed.
- The scripts call /home/root1/.openclaw/scripts/task-callback.sh (absolute path) but that file is not included. Confirm where your task-callback.sh lives and edit the scripts to use $HOME or the correct path if needed. Hardcoded /home/root1 paths are fragile and could cause failures or unexpected behavior.
- The workflow reads session data (~/.openclaw/agents/main/sessions/sessions.json) and passes session keys to a callback script to send notifications; sessions often contain sensitive tokens. Make sure you trust the callback mechanism and inspect task-callback.sh to verify it does not send these keys elsewhere.
- The SKILL.md enforces an operational rule (“never run commands yourself, always delegate after user confirmation”), but that is an instruction only — the agent could still invoke the scripts autonomously. If you are concerned about autonomous modifications, restrict the agent's permissions or require explicit confirmation before any opencode run.
If you proceed, audit and (if needed) patch the scripts to remove hardcoded paths, declare/verify dependencies, and confirm the callback implementation (task-callback.sh) is present and safe.
功能分析
Type: OpenClaw Skill
Name: opencode-guide
Version: 1.0.0
The bundle provides a structured workflow and helper scripts (e.g., opencode-auto-callback.sh) designed to help an OpenClaw agent delegate code analysis and modification tasks to the 'opencode' tool. The instructions in SKILL.md emphasize user confirmation, asynchronous task management, and consistent communication, which are safety-oriented practices. While the scripts contain hardcoded paths (e.g., /home/root1/) and specific session IDs that appear to be artifacts from the author's environment, there is no evidence of malicious intent, data exfiltration, or unauthorized execution.
能力评估
Purpose & Capability
The skill claims to be a coordinator for opencode tasks and includes callback helper scripts — that aligns with its description. However the package metadata declares no required binaries while the scripts clearly require an 'opencode' CLI (and use utilities like timeout/grep/sed and SKILL.md suggests jq). The SKILL.md and README also hardcode /home/root1 paths (e.g. /home/root1/.openclaw/scripts/...), which is inconsistent with the package's postinstall that copies scripts into the installing user's ~/.openclaw/scripts. These mismatches mean the skill may fail or behave unexpectedly on real systems.
Instruction Scope
Runtime instructions tell the agent to create files and call absolute paths under /home/root1/.openclaw, and to read session information from ~/.openclaw/agents/main/sessions/sessions.json. The scripts call a separate task-callback.sh (not included) and will parse opencode JSON output. The SKILL.md also emphatically tells the agent not to analyze or modify code itself and to always delegate — that’s a behavioral constraint but not enforceable. Reading session files (sensitive) and invoking callbacks are beyond a simple 'guide' and should be explicitly declared.
Install Mechanism
There is no external download; files ship in the package. package.json includes a postinstall that copies scripts into ~/.openclaw/scripts and a preuninstall cleanup. That will write files into the user's home during install (expected for helper scripts) but is a side-effect users should be aware of. There is no use of remote URLs or extracted archives.
Credentials
The skill declares no required env/credentials, but the instructions/scripts read or expect session keys and session files (~/.openclaw/agents/.../sessions.json) and call task-callback.sh with a session key. Accessing session files (which likely contain secrets/tokens) is sensitive behavior not declared in metadata. Also missing is declaration of needing the opencode CLI or jq, which are effectively required 'environment' dependencies.
Persistence & Privilege
always:false (good). The package will install scripts into the user's ~/.openclaw/scripts via postinstall, giving the skill persistent files on disk. The scripts invoke /home/root1/.openclaw/scripts/task-callback.sh (an absolute path), which is a surprising hardcoded dependency; if the install user differs from /home/root1 the calls will fail or behave unexpectedly. The skill does not attempt to modify other skills or system-wide agent settings in the provided files.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install opencode-guide - 安装完成后,直接呼叫该 Skill 的名称或使用
/opencode-guide触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
opencode-guide v1.0.0
- 首次发布:全面整理 opencode 协同流程与操作规范
- 明确“只做协调/传话筒,不做实际执行”的核心原则
- 详细规范常见任务流,包括用户确认、权责分明的分派、必须使用自动回调脚本
- 列举关键错误案例与正确做法对比,强调保持与用户及时沟通
- 提供任务文件模板、Session 管理策略与常见问题排查步骤
- 新增自动回调机制的详细说明,废弃旧脚本,提升通知与任务管理体验
元数据
常见问题
Opencode Guide 是什么?
协调并转达用户需求给 opencode 执行代码分析和修改,确保确认后异步使用自动回调脚本执行并汇报结果。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 103 次。
如何安装 Opencode Guide?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install opencode-guide」即可一键安装,无需额外配置。
Opencode Guide 是免费的吗?
是的,Opencode Guide 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Opencode Guide 支持哪些平台?
Opencode Guide 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Opencode Guide?
由 wangning823-arch(@wangning823-arch)开发并维护,当前版本 v1.0.0。
推荐 Skills