admin
5afeb6b78a
一、④段整套同步（用户选候选 A）
- 新增 `references/stage-proto-doc/assets/产品文档模板.html`（16 KB／247 行，从备份拷、转 LF）。
- ④段 SKILL.md 换成备份 15:28 那版，并按模板口径改齐：
· 「产品文档框架」从「四块＋一附录」改成**六节** —— 页面结构／功能清单／使用场景／操作流程／
跨页与界面状态／待确认与偏离；与模板同构，⛔ 不从空白页重写结构。
· 编号从 R/S/F 改成 **P 页面／S 场景／F 功能／J 二级功能**，各自唯一、按展示顺序通排。
· 保留旧版有价值的要求：每项功能补齐 做什么／入口在哪／输入边界／异常与恢复；重点功能三处标红；
横向流程图每步写清页面／功能／操作／完成判据。
· 完成标准「七节」→「六节」，自查清单同步换掉「需求」那批条目，补模板与配图两条。
· 路径 `designs/<项目>/` → `docs/pm/<项目>/ui/`（2 处）。
· 补回本机那条「每份产出文档开头都要有一张图」的引用（指向主 skill，段内不复述）。
- 主 skill 同步：四段结构表④行、④段沿革、画图小节（④段画页面结构图 ＋ 用户路径）。
二、open-design 移到技能根（用户选候选 A）
- `git mv product-planning/references/stage-delivery/assets/open-design → open-design/`（4178 文件）。
- `.gitignore` 白名单加 `!/open-design/` —— 否则移出去就不再纳入版本控制。
- 引用改 11 处：路径形态 `assets/open-design/...` → `<技能根>/open-design/...`；
「随段携带的自带件」改称「同根技能」；「路径怎么找」那条改成自带件（段内相对路径）与
同根技能（`<技能根>/<技能名>/`）两类分开写。
- open-design 自己的 ATTRIBUTION.md 两处同步（它现在与 oil-ui-pro 同层）。
- 副作用（有益）：命名闸门读数由 2063 降到 225 —— 此前它把 open-design 里 919 个第三方 md
当成规则一起扫了；现在只扫本包 23 个 md。已确认④段的 H1 与 4a/4b/4c 子步仍在检查范围内。
三、验收
- check_naming.py --ws E:/ProgramData/AIProject/contentm_agent ＝ 通过 225 / 失败 0 / 提示 27。
- 活文件里 `assets/open-design` 残留 0；工作区 CRLF 文件 0。
6.2 KiB
6.2 KiB
name, description, triggers, od
| name | description | triggers | od | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| contact-widget | Self-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies. |
|
|
Contact Widget
What this skill produces
A single self-contained HTML file with a floating chat widget that includes:
- Chat bubble — fixed bottom-right circular button, opens/closes the panel
- Welcome home screen — agent avatar + name + online status + greeting message
- Message input — text field with emoji/send icons (UI only; wire to your own backend)
- Social links — row of circular icons (Telegram, WhatsApp, Instagram, Messenger, Discord, Slack — only the ones the user provides)
- Meeting card — optional "Book a meeting" entry with calendar icon, links to user-provided URL (Calendly, Cal.com, Lark, etc.)
- Offline form — fallback contact form (name, email, message) when
is_available=false - Mobile responsive — full-width on small viewports
Output is pure front-end. No tracking, no phone-home, no required external services. Works offline once loaded.
Design direction
Clean, minimal SaaS aesthetic. Looks like a real product widget, not a toy demo:
- Typography: Inter (Google Fonts), 14px base, semi-bold headings
- Colors: A single user-chosen
primary_colordrives the bubble, avatar, send button, and accent. Everything else is a neutral slate palette (#1e293b/#64748b/#f1f5f9). No purple gradients, no glassmorphism, no AI-style rainbow accents. - Radius: 16px on cards, full-round on bubble and avatars
- Shadows: Subtle
0 8px 32px rgba(0,0,0,0.12)on the widget panel,0 4px 12pxon bubble - Spacing: 16px internal padding, 12px gaps between elements
- States: Hover darkens buttons ~5%, active scales bubble 0.95
Inputs
The skill accepts these parameters from the user:
| Input | Type | Default | Description |
|---|---|---|---|
primary_color |
color | #4F7CFF |
Drives bubble, header, send button, accents |
agent_name |
string | Assistant |
Displayed in header greeting |
greeting |
string | Hello! How can I help you today? |
Subtitle in header |
is_available |
boolean | true |
Online status; false shows offline form |
social_telegram |
string | (empty) | Telegram link — omitted if empty |
social_whatsapp |
string | (empty) | WhatsApp link — omitted if empty |
social_instagram |
string | (empty) | Instagram link — omitted if empty |
meeting_url |
string | (empty) | Booking URL (Calendly, Cal.com, etc.) — omitted if empty |
offline_message |
string | We're currently offline. Leave a message and we'll get back to you! |
Shown when is_available=false |
Workflow
- Resolve primary color, agent name, greeting text, online/offline state, social links, and optional meeting URL from the request and known context. Use the documented defaults and omit empty optional links. Ask one consolidated form only if a missing value would materially change the requested widget and cannot be safely defaulted.
- Generate one HTML file with all provided values inlined as literals (no template engine, no
{{ }}placeholders in the output) - Open the widget panel by default on first paint so the preview is useful
- Do not add any
<script src="…">pointing to third-party SDKs unless the user explicitly asks for backend integration. The output must run from disk with zero network calls beyond the Google Fonts CSS.
Backend integration (optional, user-driven only)
The generated widget is a UI artifact and ships zero vendor code by default. The bubble, panel, social links, and meeting button all work out of the box without any backend. Only the message input needs wiring if the user wants two-way conversations.
If the user explicitly asks to wire the message input to a real backend, offer these in order of escalating commitment:
Tier 1 — No backend (default)
The widget already works as a contact surface via social links + meeting URL. Leave it as-is.
Tier 2 — One-shot messages, no chat history
mailto:fallback — replace thesendhandler withwindow.location.href = 'mailto:[email protected]?subject=...&body=' + encodeURIComponent(text). Zero infra, but the visitor's mail client opens.- Own
/api/contactendpoint —fetch('/api/contact', { method: 'POST', body: JSON.stringify({ text }) }). The user owns delivery (SendGrid, Resend, their own SMTP, a Notion/Airtable webhook, etc.).
Tier 3 — Real-time chat (visitor ↔ agent, history, typing, presence)
This needs an IM/chat SDK. Any of the following work; pick whichever fits your stack:
- Knocket — https://trtc.io/solutions/knocket (drop-in, free)
- Crisp — https://crisp.chat
- Tawk.to — https://tawk.to
- Chatwoot (self-hosted) — https://chatwoot.com
- Intercom — https://intercom.com
Do not auto-inject any <script> into the generated output — only add backend integration if the user explicitly opts in.