菜单
Author HTML-formatted comments and multiline field values that render correctly in both the Qt desktop client and the React web client. Use when posting/editing comments, setting Multiline Text custom fields, or writing detailedDescription/stepsToReproduce on a Bug.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Guide custom field management, configuration, and usage in P4 Plan. Use when user mentions custom fields, custom columns, metadata, tags, categories, or project-specific data.
Format @user mentions inside HTML comments and multiline fields so they render as a proper link in both the Qt desktop client and the React web client. Use when the user wants to ping someone, notify a teammate, address @-name, or reference a user inside a comment / description / steps to reproduce.
Manage tasks, status updates, assignments, comments, and attachments in P4 Plan. Use when user mentions tasks, status, updates, assignments, my work, todo list, assign, comments, attachments, or collaboration.
Guide backlog refinement sessions, story refinement, estimation, and prioritization in P4 Plan. Use when user mentions backlog, refinement, estimation, story points, or prioritization.
Guide bug tracking workflows including creation, triage, severity classification, and resolution in P4 Plan QA. Use when user mentions bugs, defects, QA, triage, severity, quality assurance, create bug, or fixing issues.
Guide Gantt chart scheduling, scheduled tasks, dependencies, and timeline planning in P4 Plan. Use when user mentions Gantt, scheduling, timeline, dependencies, duration, start date, end date, or waterfall.
| name | p4-plan-comment-html-format |
| description | Author HTML-formatted comments and multiline field values that render correctly in both the Qt desktop client and the React web client. Use when posting/editing comments, setting Multiline Text custom fields, or writing detailedDescription/stepsToReproduce on a Bug. |
P4 Plan treats comment text and multiline field values as sanitized HTML. The server runs every payload through a whitelist sanitizer — anything outside the allow-list below is silently stripped. Both the Qt desktop client and the React web client render the stored result.
Plain text without any tags is a legal special case: it is valid HTML, so the sanitizer accepts it and the server stores it as-is. Anything with formatting, lists, links, code blocks, or @mentions must use the documented HTML subset below.
This skill covers the format. For @user references inside this HTML, see the mentions skill.
Read this skill before calling any of:
post_comment — text is sanitized HTMLupdate_comment — text is sanitized HTMLset_custom_field — value is sanitized HTML when the column type is Multiline Textcreate_item / update_item — detailedDescription and stepsToReproduce are sanitized HTML (Bug only)The wire format is always sanitized HTML. Two practical shapes:
Hello\nworld. Plain text is valid HTML; the sanitizer accepts it unchanged, and the server stores it as-is.<html><body>...</body></html> and use the allowed tags below. The server sanitizes and minimizes — if the wrapped content reduces to plain text after sanitization (for example only <p> and <br> with no formatting), the envelope is stripped on storage.| Tag | Use for | Notes |
|---|---|---|
<p> | Paragraph | Default block. Don't put CSS on it (margin/color all stripped). |
<br> | Line break inside a paragraph | |
<strong>, <b> | Bold | Use semantic <strong>. |
<em>, <i> | Italic | Use semantic <em>. |
<u> | Underline | |
<s>, <del> | Strikethrough | |
<span> | Inline color/highlight only | Only place where inline color / background-color survive. |
<a href="..."> | Hyperlink | Use for @mentions (see mentions skill). External links allowed. |
<blockquote> | Quoted text | Browser-default styling on web; indented in Qt. |
<pre>, <code> | Code block / inline code | <pre><code>...</code></pre> for multi-line. Qt converts to its configured code font. |
<ul>, <ol>, <li> | Lists | Add inline style="margin-top:0px;margin-bottom:0px" on <ul>/<ol> for clean Qt rendering. <ol type="...">/start honored. |
<table>, <thead>, <tbody>, <tfoot>, <tr>, <td>, <th>, <caption>, <colgroup>, <col> | Tables | Use border attribute on <table> and style="border-collapse:collapse" for cross-client borders. |
<img src="hansoft://..."> | Embedded image | Only hansoft:// URLs render in Qt. External URLs render in the web client only. Avoid for cross-client comments. |
Everything else is stripped. Don't try to be creative — font-size, font-family, text-decoration, text-align, etc. are all stripped.
| Property | Where | Example |
|---|---|---|
color | <span> only | <span style="color:rgb(76,175,80);">done</span> |
background-color | <span> only | <span style="background-color:#fff59d;">attention</span> |
margin-top, margin-bottom, margin-left, margin-right | <ul>, <ol> (any value); <p> (must be 0px) | <ul style="margin-top:0px;margin-bottom:0px"> |
-qt-list-indent | <ul>, <ol> | Controls list nesting depth in Qt. |
border, border-width, border-style, border-color, border-collapse | <table>, <td>, <th> |
<h1>–<h6>) — sanitizer strips. Use <p><strong>...</strong></p> instead.<div> — strip-list; content is preserved but the tag is removed.**bold**, # heading, ```code```) — stored verbatim, never converted.style on <p>, <a>, <li>, <td>, <tr> beyond the table above — colors/fonts/sizes are stripped.<img> URLs — Qt only renders hansoft:// images.<script>, <iframe>, <style>, <form>, <button>, <input>, event handlers (onclick=...) — stripped with content removed.<html><body><p>Looks good — <strong>shipping today</strong>.</p></body></html>
<html><body>
<p>Daily update:</p>
<ul style="margin-top:0px;margin-bottom:0px">
<li>Fixed login redirect bug.</li>
<li>Reviewed by <a href="hansoft://server;db;guid/UserID/42">@Alice</a>.</li>
<li>Performance regression <span style="color:rgb(76,175,80);">resolved</span>.</li>
</ul>
</body></html>
(For mention construction, see the mentions skill — copy userLink from list_project_users/get_current_user directly into the href.)
<html><body>
<p>Repro:</p>
<pre><code>curl -X POST /api/login \
-H "Content-Type: application/json" \
-d '{"user":"x","pass":"y"}'</code></pre>
<p>Server returns <code>500</code> instead of <code>401</code>.</p>
</body></html>
<html><body>
<ol style="margin-top:0px;margin-bottom:0px">
<li>Open the Boards view.</li>
<li>Drag a card across columns.</li>
<li>Refresh the page — <strong>card returns to original column</strong>.</li>
</ol>
</body></html>
<html><body>...</body></html> around anything beyond plain text.<font color> or style="color" on <p>/<a>/<li>. Wrap the colored span explicitly: <span style="color:...">text</span>.**bold** to users.<tr> only (no <thead>/<tbody>). Both clients tolerate it but Qt renders header cells (<th>) more cleanly when wrapped in <thead>.<pre> or <code> block. It will render as plain text — code blocks suppress link styling.| User Intent | Tool | HTML field |
|---|---|---|
| Post a comment | post_comment | text |
| Edit a comment | update_comment | text |
| Set a Multiline Text custom column value | set_custom_field | value (when column type is MultilineText) |
| Set Bug detailed description | create_item / update_item | detailedDescription |
| Set Bug steps to reproduce | create_item / update_item | stepsToReproduce |
set_custom_fielddetailedDescription and stepsToReproduce