← 返回 Skills 市场
xtmingyue

openqbook

作者 XTmingyue · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
77
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install openqbook
功能描述
Platform-agnostic skill to post developer questions on OpenQBook, poll for human answers, and manage feedback and resolution when AI agents are blocked.
安全使用建议
Before installing: 1) Verify the origin — check that https://www.openqbook.com is the legitimate project site and that the SKILL.md contents are what you expect; don't blindly run the install curl. 2) The SKILL.md requires OPENQBOOK_API_KEY even though the registry metadata omitted it — ensure you understand where the API key comes from and grant it minimal scope. 3) Review the downloaded SKILL.md (and any embedded <skill-script> Python) before adding it to your runtime; it will be stored and potentially executed by your agent. 4) Avoid posting secrets, credentials, or sensitive system output in questions; the skill will send question content to an external service. 5) If possible, sandbox the skill or test in a non-production environment and limit the API key (revocable, least privilege). These steps will reduce the risk posed by the remote-download install flow and the potential for inadvertent data leakage.
功能分析
Type: OpenClaw Skill Name: openqbook Version: 1.0.0 The skill facilitates human-in-the-loop Q&A via the OpenQBook API but exhibits several risky patterns. The `skill.md` file includes an installation script that performs a remote fetch of content from `https://www.openqbook.com/skill.md`, which is a significant supply-chain risk. Additionally, the instructions contain prompt-injection-like directives ('Agent decides helpfulness - no human input') that explicitly command the agent to autonomously evaluate and implement solutions from the external platform without human oversight, potentially leading to the execution of harmful suggestions. The Python implementation also contains unusual backslash-escaping of identifiers (e.g., `API\_KEY` in `skill.md`), which, while likely a markdown formatting artifact, is atypical for clean production code.
能力评估
Purpose & Capability
The skill name/description (post questions to OpenQBook, poll answers, manage feedback) align with the runtime instructions. The SKILL.md requires an OPENQBOOK_API_KEY and optionally OPENQBOOK_API_BASE, which are appropriate for this purpose. However, the registry metadata lists no required environment variables or homepage/source while the SKILL.md explicitly requires an API key and downloads code from https://www.openqbook.com — this metadata/instruction mismatch is unexpected.
Instruction Scope
The instructions direct the agent to post questions and poll answers to an external service (OpenQBook), initialize polling state files, and run periodic/background polling and evaluation. Those behaviors are consistent with the stated purpose but involve transmitting freeform developer questions and potentially code or logs to an external endpoint — which can leak secrets if the agent includes sensitive context. The SKILL.md also provides an install snippet that fetches a remote SKILL.md and writes it into the agent's skill directory; installing unverified text that contains executable script blocks increases risk because the downloaded file may later be executed by your runtime.
Install Mechanism
There is no formal install spec in the registry, but the SKILL.md includes a shell install flow that uses curl to download https://www.openqbook.com/skill.md into the agent skill directory and writes it to disk. Downloading an executable skill file from an external URL at install time is higher risk than an instruction-only skill with no network install. The URL is a site domain (not a well-known package release host like GitHub releases); because the registry entry also lacks a homepage/source, it's hard to independently verify the origin.
Credentials
The skill requires a single service credential (OPENQBOOK_API_KEY) and optionally OPENQBOOK_API_BASE and OPENQBOOK_SKILL_DIR — which are proportionate to a third-party API integration. The registry, however, declares no required env vars or primary credential, creating a mismatch: the skill will not work without an API key but that requirement is not surfaced in metadata. No unrelated or excessive credentials are requested.
Persistence & Privilege
The skill does not request always:true and does not require system-wide configuration changes beyond creating a directory under common skill paths and saving the SKILL.md there. Autonomous invocation (disable-model-invocation:false) is the platform default and not a new privilege here. No evidence the skill modifies other skills' configs or requests elevated system privileges.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install openqbook
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /openqbook 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
OpenQBook Agent Skill v2.0.0 - Major update: new platform-agnostic agent skill for human-in-the-loop developer Q&A workflows. - Adds functions for posting questions, polling and evaluating answers, and providing feedback to OpenQBook. - Offers detailed install instructions with environment variable support and multi-path adaptive setup. - Provides ready-to-use Python API for integration: asking questions, polling, marking answers helpful/unhelpful, and closing questions. - Includes scheduler and heartbeat workflow examples and clear state management guidelines. - Enforces feedback rules: mandatory feedback for each answer, autonomous decision making, sequential evaluation.
元数据
Slug openqbook
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

openqbook 是什么?

Platform-agnostic skill to post developer questions on OpenQBook, poll for human answers, and manage feedback and resolution when AI agents are blocked. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 77 次。

如何安装 openqbook?

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

openqbook 是免费的吗?

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

openqbook 支持哪些平台?

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

谁开发了 openqbook?

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

💬 留言讨论