MD反馈
检查你的计划。指导你的AI代理。信心十足的船。
MD反馈 是一个VS Code扩展和MCP服务器,用于在AI代理实施降价计划之前对其进行审查。用“修复”、“问题”和“突出显示”注释计划——AI代理直接通过MCP读取您的结构化反馈。无需复制粘贴,无需导出步骤,会话之间不会丢失上下文。
从以下位置安装 VS代码市场,打开a .md 计划,选择文本,按 1/2/3,您的代理人可以立即对该审查采取行动。
你复习。代理构建。盖茨轨道完工。交接保留了上下文。
最新版本(v1.5.7):Web用户界面 npx md-feedback --在任何浏览器中打开您的markdown工作区。运作原理
从计划到实施,完整的AI编码循环:
Step 1 YOU Write a plan in markdown
│
Step 2 YOU Open in MD Feedback sidebar → highlight, fix, question
│ (press 1, 2, or 3)
│
Step 3 AGENT Reads annotations via MCP — no export step needed
│
Step 4 AGENT Implements fixes, answers questions
│
Step 5 YOU Review AI work → Approve, Request Changes, or Reject
│
Step 6 AGENT Gates auto-evaluate
│ "3 fixes remaining" → "All done, ready to merge"
│
Step 7 AGENT Generates handoff → next session picks up where you left off执行步骤1-2和5。代理人做剩下的事。
这是MCP的第一条路径。如果使用基于导出的工作流,请在步骤2后运行导出。
特性
- 3种注释类型:突出显示(阅读标记)、修复(需要更改)、提问(需要澄清)
- 27个MCP工具 用于直接代理集成
- 导出到11个AI工具:克劳德密码、光标、复制品、Codex、Cline、风浪、Roo密码、双子座、反重力、通用、切换
- 质量门 具有自动通过/失败评估功能
- 会话切换 在AI代理会话中保留上下文
- 检查点 使用快照跟踪审核进度
- 计划光标 跟踪文档中的当前位置
- 键盘快捷键:按1、2、3进行即时注释
- AI应用修复程序 通过MCP代理报告实现,您可以看到内联前后差异
- 7个身份徽章:打开、正在工作、回顾、已回答、已完成、失败、无法修复
- 回滚:如果出现问题,代理可以撤消其上次更改
- 批量操作:在一个事务中应用了多个修复程序
- 安全文本替换:当同一文本多次出现时,代理必须指定要更改的文本(防止意外错误的行编辑)
- 文件安全:阻止写入.env、凭据、node_modules
- 批准/拒绝按钮 --内联接受或取消注释,需要查看时始终可见
- 编辑器中的CodeLens --直接在markdown文件中批准或拒绝,不需要侧边栏
- 活动栏徽章 --查看待审核计数概览
- 状态栏+吐司通知 --永远不要错过AI交付工作以供审查的时刻
- 键盘快捷键 --Ctrl+Shift+A表示批准,Ctrl+Shift+X表示拒绝
- 闸门超控 --当自动评估不够时,手动控制闸门状态
- 内联外部文件差异 --在应用之前,看看人工智能会发生什么变化
- 登机口过渡通知 --知道闸门何时解锁或完成
- 并行安全 --防止多个AI操作同时运行时数据损坏
- 自动刷新:AI写入更改时实时更新文档
- 便携式格式:以HTML注释形式存储的注释——适用于任何markdown渲染器,在git中幸存
- 丰富的渲染:美人鱼图、标注块、语法高亮代码
快速入门(不到2分钟)
- 安装 从 VS代码市场
- 先注释 --在markdown文件中选择文本,然后按
1(突出显示),2(修复),3(问题) - 可选:连接MCP --第一次注释后,单击
Connect AI在侧栏中,将配置添加到MCP客户端:
{ "mcpServers": { "md-feedback": { "command": "npx", "args": ["-y", "md-feedback"] } } }- 完成 --MCP兼容代理直接读取注释。如果您的代理仅导出(例如当前的Copilot流),请使用导出。
需要Node.js 18+ 对于MCP(npx). 克劳德路径:.claude/mcp.json\ 光标路径:.cursor/mcp.json
现在试试: 从以下位置安装 市场,打开任何.md文件,然后按2添加您的第一个Fix注释。
用例
Vibe编码工作流程
用马克写一个计划。与MD反馈一起审查。让你的AI代理准确构建你所审查的内容。计划是合同,注释是说明。
人工智能计划审查
AI代理生成实施计划。在代理编写任何代码之前,您可以通过突出显示、修复和问题对其进行审查。在设计时捕捉错误,而不是在实现后。
会话连续性
在多个会话中使用AI?移交保留了每一个决定、未决问题和关键背景点。下一节课从上一节课结束的地方开始。
团队计划评审
注释是markdown文件中的HTML注释。它们在git提交、PR和分支合并中幸存下来。通过正常的版本控制工作流程与您的团队共享已审核的计划。
质量门执行
设置代理继续之前必须满足的条件。Gates根据注释解析状态自动评估——已阻止、继续或已完成。
设计理念
- 人类只会说什么是错的。 AI决定如何修复它。
- 三种注释类型就足够了。 AI根据上下文推断意图——无论修复意味着文档编辑还是代码更改。
- Markdown是真理的源泉。 所有州都存在于文件本身中。
- 零认知负荷。 状态栏被动显示进度。不需要额外的决定。
- 便携且git友好。 注释是HTML注释——它们在任何markdown渲染器和版本控制中都存在。
VS代码设置
您可以通过以下方式从VS代码设置中自定义MD反馈 md-feedback.*. 高级计时和性能调优选项可用于大型工作区。
MCP 服务器
MD Feedback包括一个带有27个工具的MCP服务器,可以让AI代理读取您的注释,而无需手动导出。代理可以通过模型上下文协议查询备忘录、标记已完成的任务、应用修复、检查门状态和生成切换。
设置:
npx md-feedback工作区覆盖 --如果您的MCP客户端未设置 cwd 在项目文件夹(例如Antigravity)中,明确指定它:
{ "command": "npx", "args": ["-y", "md-feedback", "--workspace=/path/to/project"] }Windows示例: { "command": "npx", "args": ["-y", "md-feedback", "--workspace=C:\\\\work\\\\my-project"] }\ 或者通过环境变量: MD_FEEDBACK_WORKSPACE=/path/to/project
有关完整详细信息,请参阅 MCP服务器文档.
链接
许可证
SUL-1.0 --个人和非商业用途免费。
______________________________________________________________________
常见问题解答
什么是MD反馈? MD Feedback是一个VS Code扩展和MCP服务器,用于在AI代理实施降价计划之前对其进行审查。选择文本,按1(突出显示)、2(修复)或3(问题)——注释作为可移植的HTML注释存储在markdown文件本身中。AI代理直接通过MCP读取注释,或者您可以导出到11个AI工具。
它是否适用于克劳德代码/光标/复制? 对。MD反馈导出到Claude Code(CLAUDE.md),光标(.cursor/rules/)GitHub Copilot(.github/copilot-instructions.md)以及另外8个工具。使用MCP,代理可以直接读取注释,不需要导出步骤。
什么是MCP,为什么它很重要? MCP(模型上下文协议)允许AI代理与外部工具进行交互。MD Feedback的MCP服务器允许代理直接访问您的注释,因此他们可以读取反馈、标记已完成的任务、评估关卡并自动生成切换。例如,当您将一个部分标记为“修复:在这里使用重试逻辑”时,代理通过MCP读取该注释,实现修复,并将其标记为完成——所有这些都不需要您切换选项卡。
多个人可以审查同一个计划吗? 对。注释是嵌入在markdown文件中的HTML注释。它们通过git与文件一起传输——提交、分支、拉取请求和合并——所有这些都保持了注释的完整性。
免费吗? 对。MD Feedback可免费用于个人和非商业用途 SUL-1.0 许可证。
这是给谁的? 使用人工智能编码助手的开发人员希望在实施前审查计划,在会话中保留上下文,并向代理提供结构化反馈,而不是非结构化聊天消息。
更多问题和高级指导: MCP服务器文档 和 .
