opendots
Use when implementing OpenDots-style user-reviewed AI proposals in MDE: editable drafts in existing forms, Accept/Edit/Ignore, exact-draft binding, source evidence, safe authenticated saves, version conflicts, idempotent retries, or persisted receipts after refresh. Do not install OpenDots.
- License 许可
- MIT
- 所属仓库
- amoai-tech/mdeai
- 最近更新
- 2026-11-13
- Stars
- ★ 2
- Forks
- 1
01 前言 Front Matter
- name
- opendots
- description
- Use when implementing OpenDots-style user-reviewed AI proposals in MDE: editable drafts in existing forms, Accept/Edit/Ignore, exact-draft binding, source evidence, safe authenticated saves, version conflicts, idempotent retries, or persisted receipts after refresh. Do not install OpenDots.
02 资源文件 3
- 参考文档evals/evals.json6.9 KB
- 参考文档evals/trigger-evals.json1.9 KB
- 参考文档references/source-map.md3.3 KB
03 SKILL.md 正文
OpenDots — review and genuinely save AI suggestions
Owner and boundaries
Own AI proposal → user edit/review → confirmed canonical write → durable receipt, not a separate editor/store/approval engine. Shared schema owner: SAN-1548 (src/platform/contracts/review-proposal.ts); domain services own writes. Use copilotkit for installed v2 tool/interrupt compatibility, mastra for agent tools, and supabase for transactions and tenant RLS.
Accept/Edit/Ignore is user control over AI suggestions, not a prelaunch business approval or property/photo/publishing eligibility gate. Manual form submission remains available. Ignore/Cancel writes nothing.
Implementation procedure
- Trace one real action. Identify signed-in actor, target, existing form, allowed fields, API/RPC, transaction and readback. Check actual PR base: signup suggestion UI on #403/#404 may not exist on main. Load the matching pinned source map.
- Model the source accurately. Upstream OpenDots PageReviewCard.tsx provides approve/save, decline and receipt/conflict recovery; it has no Edit button. Implement editing through existing MDE owner forms and bind the edited final draft, not the original AI text.
- Bind and revalidate before writing. Reuse proposalId, target, baseVersion and draftHash from SAN-1548; include tool-call and source identity only if needed. Server must recompute draft binding and authorize each write. A prior upstream receipt missing reviewDraft is a legacy compatibility exception, not a safe default for new MDE saves. Changed drafts or stale target revisions reject without overwriting edits.
- Require committed readback. A schema-valid receipt with status "saved" does not alone prove a database commit. Derive the outcome from the canonical write and authorized readback (real ID/version when available). If a response is lost after commit, recover the identical saved result; don't issue another irreversible write. Cancel/Ignore/deny: zero writes.
- Use existing domain write owner. Partner profiles reuse SAN-814's merged partner_profile_patch RPC; events reuse existing publishing transactions; rentals reuse existing lead/viewing RPCs. Never copy OpenDots SQLite or add an alternative review database. Migrations belong only to verified domain schema gaps.
- Prove actual behavior. Exercise Accept/Edit/Ignore, altered same-ID draft, version conflict, two authorized concurrent edits, partner A/B isolation, missing evidence, double-click, response loss and refresh. Inspect actual persisted records, not just toast or HTTP 200. Run focused Vitest/pgTAP/Playwright and exact-head checks.
Example
A café owner edits AI-suggested description and confirms. A reload displays the edited Supabase value; Ignore writes nothing and a duplicate retry returns the same persisted outcome.
- Source-to-destination map.
- Behavior probes and Trigger/near-miss probes.
- Skill routing is not proof of a real database save.
04 同仓库更多 Skills
mde-pr-review-supabase
Use when reviewing MDE Supabase SQL, Auth and RLS changes in a pull request.
mde-pr-review-stripe
Use when reviewing MDE Stripe payments and webhooks changes in a pull request.
mde-pr-review-nextjs
Use when reviewing MDE Next.js App Router changes in a pull request.
mde-pr-review-mastra
Use when reviewing MDE Mastra agent, tool and workflow changes in a pull request.
mde-pr-review-maps
Use when reviewing MDE Google Maps and Places changes in a pull request.
mde-pr-review-copilotkit
Use when reviewing MDE CopilotKit and AG-UI changes in a pull request.