用途:该技能是 Velt Suggestions API 的实现指南,用于在 React、Next.js 和 Web 应用中添加建议模式(propose-then-review)。编辑内容(来自人类或 AI 智能体)会被捕获为提案,由审核者接受或拒绝。
主要能力:包含 6 个类别共 14 条规则,按优先级分为 Core(CRITICAL,前缀 core-)、Targets(CRITICAL,targets-)、Mode(HIGH,mode-)、Capture(HIGH,capture-)、Lifecycle(HIGH,lifecycle-)、Data(MEDIUM,data-)。适用场景包括:为表单输入、表格或自定义组件添加建议模式;实现 AI 提议、人类审核的工作流;将 data-velt-suggestion-target 属性绑定到 DOM 元素;处理接受/拒绝事件并应用已接受的更改;按目标或状态查询建议以构建自定义 UI;理解建议生命周期状态(pending → accepted/rejected/stale)。
使用方式:资料提供两个编译文档,AGENTS.md 为所有规则的压缩索引(含文件路径,建议从此开始),AGENTS.full.md 为展开全部规则的完整详细指南。
限制与前置条件:Suggestions 依赖 Velt Comments 已配置完成,接受/拒绝 UI 渲染在 Velt 评论对话框上;添加 Suggestions 前需确保 VeltProvider 已配置 authProvider 且 Comments 正常工作。资料未提供具体安装命令、代码示例、收费或平台细节。