← 返回 Skills 市场
Principles Agent
作者
lingxinsuixing
· GitHub ↗
· v0.2.0
· MIT-0
123
总下载
0
收藏
1
当前安装
2
版本数
在 OpenClaw 中安装
/install principles-agent
功能描述
基于第一性原理思维的迭代式 Agent,拆解复杂目标为原子任务,自动验证调试并依赖感知执行保证最终交付质量。
安全使用建议
This skill appears coherent and consistent with its description: it orchestrates decomposition and delegates LLM calls to the host. Before installing, note: (1) run it inside OpenClaw or provide a proper llm_call function — the CLI will raise if llm_call isn't injected; (2) the code contains some minor implementation issues (some methods build prompts then parse the prompt as if it were an LLM response), which are likely bugs rather than malicious behavior; (3) the skill writes a report only when you pass --output (so be cautious about the output path you provide). If you plan to run this in production, review the code for robustness around JSON extraction and error handling and test it in a sandboxed OpenClaw session first.
功能分析
Type: OpenClaw Skill
Name: principles-agent
Version: 0.2.0
The principles-agent skill is a legitimate implementation of a task-decomposition framework based on first-principles thinking. The code (orchestrator.py, executor.py, etc.) focuses entirely on logic flow, iterative refinement, and topological sorting of tasks, relying on the host environment to provide LLM access. It adheres to its stated permission boundaries, containing no network requests, environment variable access, or unauthorized file system operations. The internal prompts used for the AI agent are strictly aligned with the framework's purpose and do not contain malicious instructions or injection attempts.
能力评估
Purpose & Capability
Name/description match the code: modules implement goal clarification, truth derivation, task breaking, refinement, dependency sorting, execution via an injected llm_call, validation, and integration. The skill declares no external credentials or network use, which aligns with the implementation that expects an injected llm_call from the OpenClaw host.
Instruction Scope
SKILL.md states the skill never calls network or reads environment variables; the code follows that pattern by expecting an injected llm_call and not performing outbound requests or reading env vars. Minor implementation inconsistencies: cli.py expects a global 'llm_call' (will raise if run outside an OpenClaw session), and some library methods expose APIs that build prompts and then call the local _parse_response on the prompt (i.e., parse the prompt as though it were an LLM response) — these are likely bugs but not malicious behavior. The skill writes files only when the user supplies --output.
Install Mechanism
No install spec provided (instruction-only install), and there are no downloads or package installs. The skill ships source files but does not declare or perform any network-based installation — low install risk.
Credentials
The skill requires no environment variables, no credentials, and no config paths. All LLM access is expected to be provided by the host via a callable 'llm_call'. This is proportionate to the stated orchestration purpose.
Persistence & Privilege
The skill does not request persistent or elevated privileges (always: false). It does not modify system configuration or other skills. File writes are user-initiated via --output only.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install principles-agent - 安装完成后,直接呼叫该 Skill 的名称或使用
/principles-agent触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v0.2.0
**principles-agent 0.2.0 — 架构更新,权限边界细化**
- 明确分离 skill 与主 Agent 职责,skill 仅负责任务规划与验证,主 Agent 负责所有实际操作与 LLM 调用
- 新增权限边界声明:skill 不直接访问网络、不读环境变量、不主动写文件,全部 IO 由主 Agent 托管
- 工作流程和架构目录细化,增强分层质量验证和依赖识别逻辑
- 文档更侧重安全与最小权限原则,提升透明度
v0.1.0
- Initial release of principles-agent: an iterative agent framework based on first principles thinking.
- Provides atomic-level task decomposition, iterative refinement, dependency-aware scheduling, and multi-level validation.
- Integrates with OpenClaw and leverages its built-in LLM for processing.
- CLI interface supports task execution, file output, and max iteration configuration.
- Suitable for complex system design, deep problem analysis, and multi-agent scenarios.
元数据
常见问题
Principles Agent 是什么?
基于第一性原理思维的迭代式 Agent,拆解复杂目标为原子任务,自动验证调试并依赖感知执行保证最终交付质量。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 123 次。
如何安装 Principles Agent?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install principles-agent」即可一键安装,无需额外配置。
Principles Agent 是免费的吗?
是的,Principles Agent 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Principles Agent 支持哪些平台?
Principles Agent 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Principles Agent?
由 lingxinsuixing(@lingxinsuixing)开发并维护,当前版本 v0.2.0。
推荐 Skills