Principles Agent OpenClaw Skill

基于第一性原理思维的迭代式 Agent,拆解复杂目标为原子任务,自动验证调试并依赖感知执行保证最终交付质量。

v0.2.0 Recently Updated Updated 5 days ago

Installation

clawhub install principles-agent

Requires npm i -g clawhub

48

Downloads

0

Stars

1

current installs

1 all-time

2

Versions

principles-agent - 基于第一性原理的迭代式任务拆解框架

作者: 🖤 小黑 & 小龙

描述

基于 miltonian/principles 的设计思想,在 OpenClaw 中实现的第一性原理思维 + 迭代式开发框架。

架构职责分离:

模块 职责
principles-agent 需求澄清 → 第一性原理推导 → 原子任务拆解 → 迭代精炼 → 依赖排序 → 结果整合 → 分层验证
OpenClaw 主 Agent 实际执行 LLM 调用 → 执行子任务 → 处理外部操作 → 权限管控

skill 不直接调用 API、不访问网络、不读取环境变量,所有 IO 由主 Agent 完成。

核心能力

  1. 第一性原理需求分析 —— 剥离经验假设,回归最基础的事实和公理
  2. 原子级任务拆解 —— 将复杂目标拆解为不可再分、可验证的原子子任务
  3. 迭代式精炼 —— 自动检查并优化不满足条件的真理/子任务
  4. 依赖感知调度 —— 拓扑排序处理依赖,识别可并行批次
  5. 分层质量验证 —— 每层都验证,不通过反馈优化
  6. 全局整合验收 —— 最终交付前整体验证,保证结果满足目标

触发条件

当用户需要:

  • 从零设计一个复杂系统/项目
  • 对复杂问题进行深度分析
  • 构建多步骤多 Agent 协作系统
  • 需要按照第一性原理思维解决问题时触发

用法

直接在 OpenClaw 会话中使用:

principles "你的目标或问题描述"

可选输出到文件:

principles "你的目标" --output report.md

配置最大迭代次数:

principles "你的目标" --max-iterations 5

权限边界

principles-agent 遵循最小权限原则:

  • LLM 调用:由 OpenClaw 主 Agent 注入,skill 只接收结果
  • 文件读取:仅读取 skill 自身目录内的源代码
  • 文件写入:仅在用户通过 --output 指定时写入报告
  • 网络访问:skill 不发起任何网络请求
  • 环境变量:skill 不读取任何环境变量
  • 系统访问:不执行外部命令,不修改系统配置

工作流程

1. 接收需求 → 澄清目标,提取约束和成功标准
2. 第一性原理解构 → 推导基础事实/公理
3. 原子任务拆解 → 拆解为最小可验证子任务
4. 迭代精炼 → 检查最小性/可行性/对齐性,不满足则优化
5. 依赖排序 → 拓扑排序确定执行顺序,检测循环依赖
6. 分批执行 → 主 Agent 执行子任务,skill 验证每个结果
7. 全局整合 → 合并所有子任务结果生成完整输出
8. 最终验收 → 验证满足原始目标,交付成果

架构

principles-agent/
├── SKILL.md          # 本文件
├── package.json      # Skill 元数据和权限声明
├── cli.py            # OpenClaw CLI 入口
├── openclaw_entry.py # OpenClaw 技能入口点
└── src/
    ├── __init__.py
    ├── types_def.py           # 数据类型定义
    ├── orchestrator.py       # 总控编排
    ├── truth_deriver.py      # 基础事实推导
    ├── task_breaker.py       # 原子任务拆解
    ├── refiner.py            # 迭代精炼决策
    ├── dependency_sorter.py  # 依赖拓扑排序
    ├── validator.py          # 分层质量验证
    ├── executor.py           # 执行调度(调用主 Agent 执行)
    └── integrator.py         # 结果整合

参考资料

Statistics

Downloads 48
Stars 0
Current installs 1
All-time installs 1
Versions 2
Comments 0
Created Mar 30, 2026
Updated Mar 30, 2026

Latest Changes

v0.2.0 · Mar 30, 2026

**principles-agent 0.2.0 — 架构更新,权限边界细化** - 明确分离 skill 与主 Agent 职责,skill 仅负责任务规划与验证,主 Agent 负责所有实际操作与 LLM 调用 - 新增权限边界声明:skill 不直接访问网络、不读环境变量、不主动写文件,全部 IO 由主 Agent 托管 - 工作流程和架构目录细化,增强分层质量验证和依赖识别逻辑 - 文档更侧重安全与最小权限原则,提升透明度

Quick Install

clawhub install principles-agent
EU Made in Europe

Chat with 100+ AI Models in one App.

Use Claude, ChatGPT, Gemini alongside with EU-Hosted Models like Deepseek, GLM-5, Kimi K2.5 and many more.