feedback-loop（反馈循环）— Cursor Agent Skill

在 Cursor 中为 Agent 提供核心交互规范：在任务关键节点与用户保持反馈循环，避免在未经确认的情况下结束重要工作。需要用户在多个固定选项中做选择时，应优先使用 Cursor 的 AskQuestion 工具（参数与示例见 references/tool-usage.md）。

本仓库包含什么

路径	说明
SKILL.md	Skill 主文件：YAML 元数据、触发规则、流程图、完成确认模板、禁止行为与自检清单
references/tool-usage.md	AskQuestion 参数结构与示例
LICENSE	MIT 许可证

在 Cursor 中安装

手动放置

1. 用户级（对所有项目生效）：将本仓库放到
   ~/.cursor/skills/feedback-loop/
   Windows 一般为：%USERPROFILE%\.cursor\skills\feedback-loop\
2. 项目级（仅当前仓库）：放到
   <项目根目录>/.cursor/skills/feedback-loop/
3. 目录内须包含根级 SKILL.md；保留 references/ 以便查阅 AskQuestion 说明。

让规范稳定生效

• 依赖 Cursor 的 Agent Skills 发现机制加载本 skill（路径与版本行为以 Cursor 文档 为准）。
• 若需每条对话都强调交互纪律，可在 用户规则 或项目根目录 AGENTS.md 中写明须遵守 feedback-loop / 反馈循环（与 SKILL.md 中 <ALWAYS-ACTIVE> 的意图一致）。

会话中如何使用

• 遇歧义需求、破坏性操作、重大方案取舍、任务收尾等场景，按 SKILL.md 判断是否必须暂停并收集用户选择。
• 需要选项时：优先 AskQuestion，而不是只在自然语言里提问。

一句话安装（供自动化或复制执行）

在已安装 git、且用户授权使用终端时，可将本 skill 克隆到 Cursor 默认用户级目录（--depth 1 只拉最新提交）：

# macOS / Linux
git clone --depth 1 https://github.com/lilyjem/feedback-loop.git ~/.cursor/skills/feedback-loop

# Windows（PowerShell）
git clone --depth 1 https://github.com/lilyjem/feedback-loop.git "$env:USERPROFILE\.cursor\skills\feedback-loop"

安装到当前项目（在项目根目录执行）：

git clone --depth 1 https://github.com/lilyjem/feedback-loop.git .cursor/skills/feedback-loop

执行前注意：若目标文件夹已存在，先与用户确认是否删除、git pull 或换路径，避免覆盖未备份的本地修改。

卸载或覆盖安装

• 卸载：退出 Cursor 后删除整个 feedback-loop 文件夹即可。
• 覆盖安装：先删再执行上面的 git clone（本地有未备份修改时慎用）。

rm -rf ~/.cursor/skills/feedback-loop

Remove-Item -Recurse -Force "$env:USERPROFILE\.cursor\skills\feedback-loop" -ErrorAction SilentlyContinue

一条命令：删旧后重装（Windows / 用户级）：

$d = "$env:USERPROFILE\.cursor\skills\feedback-loop"; if (Test-Path $d) { Remove-Item -Recurse -Force $d }; git clone --depth 1 https://github.com/lilyjem/feedback-loop.git $d

核心理念（摘要）

• 该问才问：在真正需要用户判断的节点暂停，而不是每一步都打断。
• 通常必须反馈：需求歧义、破坏性操作、架构级决策、范围扩大、非琐碎任务完成前等（详见 SKILL.md）。
• 可直接做：指令明确的小修改、已批准方案的后续步骤、纯信息问答等。

如何确认在 Cursor 里已生效

• 歧义需求是否会先澄清再动手？
• 删除/覆盖类操作是否会说明影响并等待确认？
• 多选项场景是否会出现 AskQuestion（而非仅口头列举选项）？
• 非琐碎任务结束时是否会总结并请用户确认？

本地修改本 skill

克隆后可直接编辑 SKILL.md 与 references/；改完后在真实对话里做一次「歧义 → 决策 → 收尾确认」的冒烟测试。

许可证与链接

• MIT License
• 规范全文：SKILL.md
• 仓库：https://github.com/lilyjem/feedback-loop