Skip to content

README-zh.md

Latest commit

 

History

History
241 lines (166 loc) · 6.39 KB

README-zh.md

File metadata and controls

241 lines (166 loc) · 6.39 KB

🎛️ Feedback Controller

用于纠正执行偏差的闭环 Agent Skill

先看偏差，再做纠偏。

License Agent Skills Platform Version

English · 中文 · Philosophy · 哲学说明 · Install Guide · 安装指南 · Examples · 案例

Feedback Controller 是什么？

一个开源 Agent Skill，把“目标状态”和“当前输出”之间的差距当成真正的工作对象。它不会因为内容已经生成就草率收工，而是会检查偏差、定位误差来源，并选择合适的控制动作：重试、局部重写、切换工具、缩小范围，或者升级给人。

它建立在诺伯特·维纳的控制论洞见上：系统不是靠一次性指令变好，而是靠反馈闭环持续修正。在 AI 工作里，这意味着执行质量取决于系统能否感知偏差，并在误差累积之前完成纠偏。

适合谁用？

🤖 Agent 构建者
当多步任务的输出很容易偏离初衷时，在执行后使用它。

🛠️ Workflow 运营者
当自动化不该盲目重试，而应该选择性纠偏时，使用它。

📣 GTM 与运营团队
当外联写作、报告生成或流程执行必须持续贴着目标走时，使用它。

⚠️ 高风险审查者
当错误不该被悄悄自修，而必须升级处理时，使用它。

它怎么工作？

graph TD
    A["Task has a target state"] --> B["Observe current output"]
    B --> C["Measure deviation"]
    C --> D["Localize error source"]
    D --> E["Choose correction path"]
    E --> F["Next loop or escalate"]

    style A fill:#fef3cd,stroke:#d4a843
    style C fill:#e8f4f8,stroke:#5ba4c9
    style E fill:#e8f7ec,stroke:#28a745
    style F fill:#eef2ff,stroke:#4f46e5
Loading

关键动作：先把问题处理成这个 skill 需要的正确形态，再进入执行。

输出契约

每一个合格的 Feedback Controller 输出，都会以同样的六段式控制诊断收尾：

## Target State
## Current State
## Observed Deviation
## Error Source
## Correction Strategy
## Escalation Decision

使用场景

销售邮件偏离了账户 brief

输出已经存在，但在商业上并不安全。

把草稿与账户 brief 对照，明确指出偏差，然后只修正受影响的部分。

→ 完整示例

市场更新用了过期来源

系统确实产出了报告，但在‘时效性控制’这一环上失手了。

检查来源时效性，明确指出检索失败点，然后只重跑证据收集和结论两步。

→ 完整示例

客服回复变得防御性过强

这里的失败不是事实错误，而是关系层面的偏差。

保持事实部分不变，识别语气偏差，并只重写开头和道歉逻辑。

→ 完整示例

自动化在权限错误后还在持续重试

系统看起来在动，但其实没有在学习。

先停止循环，把这个故障归类为‘不可重试的权限问题’，然后转交给有权限解锁的人。

→ 完整示例

它和普通做法有什么不同？

常见做法 Feedback Controller
把“有输出”当成成功 把“偏离目标多少”当成真正信号
盲目重试 按误差类型选择纠偏路径
整段重写 优先选择最小有效修正
用自信措辞掩盖失败 明确命名失败模式
让循环无限继续 明确停止条件和升级边界

从维纳到 AI

  • 反馈比一次性指令质量更重要。
  • 控制的本质是缩小偏差，而不是炫耀复杂度。
  • 真正有用的记忆，是能改变下一步动作的反馈。
  • 人在环里的最大价值，是提供高质量纠偏信号。

→ 阅读完整哲学说明

快速安装

curl -fsSL https://raw.githubusercontent.com/clarkchenkai/feedback-controller/main/install/install.sh | bash
git clone https://github.com/clarkchenkai/feedback-controller.git
cp -r feedback-controller/feedback-controller ~/.your-platform/skills/feedback-controller

→ 完整安装指南

支持平台

平台 安装方式 状态
Claude Code ~/.claude/skills/feedback-controller ✅
Cursor Remote rule 或本地 skills 目录 ✅
OpenAI Codex ~/.codex/skills/feedback-controller 或 .agents/skills/feedback-controller ✅
Gemini CLI ~/.gemini/skills/feedback-controller ✅
Google Antigravity ~/.gemini/antigravity/skills/feedback-controller ✅
Amp / Goose / Cline ~/.agents/skills/feedback-controller ✅

项目结构

feedback-controller/
├── feedback-controller/
│   ├── SKILL.md
│   ├── agents/
│   │   └── openai.yaml
│   └── references/
├── docs/
│   ├── philosophy.md
│   └── philosophy-zh.md
├── install/
│   ├── install.sh
│   ├── README-install.md
│   └── README-install-zh.md
├── examples/
├── examples-zh/
├── scripts/
│   └── validate-docs.sh
├── README.md
├── README-zh.md
└── LICENSE

贡献

欢迎贡献，尤其是这些方向：

  • 更强的协议和示例
  • 更稳的中文镜像文档
  • 更好的平台兼容性
  • 更准确的高风险边界

更新日志

→ 版本历史

许可证

本项目使用 MIT License 发布。