CSlawyer1985/legal-skillhub / skills/ambiguity-report
ambiguity-report
Verified将法律文本(合同、法规、规章或司法意见)的诠释性歧义审查转化为精美的交付物。可生成多页面网站(默认)、单页面交互式网站、Microsoft Word 文档、PowerPoint 演示文稿或 LaTeX/PDF。当用户持有压力测试结果、歧义审查或"这将在何处被诉"场景分析,并希望发布、演示或分享时使用。触发词包括"发布审查报告"、"据此制作报告"、"将其转化为网站/演示文稿/简报/Word 文档"、"制作 Netlify 网站"、"制作这些歧义点的幻灯片"、"渲染场景"、"打包这份压力测试"、"生成 LaTeX 版本"等。与歧义压力测试技能(底层分析)配套使用,但也适用于任何结构化或半结构化的歧义分析。视觉设计有明确风格倾向,但用户可覆盖颜色、字体和品牌标识。大多数格式需要 Python 和可写的文件系统;单文件 HTML 在主机两者皆无时仍可运行。
| File | Kind | Size |
|---|---|---|
| LICENSE | other | 11.1 KB |
| NOTICE | other | 1.7 KB |
| README.md | markdown | 964 B |
| SKILL.md | skill md | 16.8 KB |
| assets/latex-preamble.tex | other | 3.8 KB |
| assets/site-style.css | other | 23.9 KB |
| resources/data-format.md | markdown | 11.7 KB |
| resources/format-docx.md | markdown | 6.5 KB |
| resources/format-inline-html.md | markdown | 3.6 KB |
| resources/format-latex.md | markdown | 6.4 KB |
| resources/format-pptx.md | markdown | 6.1 KB |
| resources/format-website.md | markdown | 6.1 KB |
| resources/parsing-unstructured.md | markdown | 6.5 KB |
| scripts/generate_latex.py | script | 19.4 KB |
| scripts/generate_site.py | script | 37.7 KB |
resources/format-docx.md
View on GitHub# 格式——Microsoft Word 文档
Word 路径生成适合诉讼律师、立法者或法律顾问审阅的单个 `.docx`——可在 Word 中阅读,具有正确的标题导航、用于改写文本的修订追踪和脚注分析。
## 委托给 docx 技能
本技能不直接实现 docx 生成。它委托给现有的 `docx` 技能(通过 Skill 工具加载)。docx 技能底层使用 `python-docx`,了解标题、样式、表格和修订追踪的模式。
**工作流程。**
1. 读取规范。
2. 调用 `docx` 技能(如果无法从此处直接调用则阅读其 SKILL.md)。
3. 遍历规范构建文档,应用下面的文档结构。
4. 保存到 `<output-dir>/report.docx`。
5. 通过主机提供的任何机制将文件交付给用户;如果没有,则陈述输出路径。
## 文档结构
Word 文档镜像多页面网站的信息架构,但采用线性通读形式。
**封面/标题页。**
- 标题:`meta.title`
- 副标题:`meta.subtitle`
- 眉题(小型大写):`meta.kicker`
- 下方:`meta.audit_date`、`meta.profile`
- 分页。
**执行摘要。**
- `meta.page_subtitle` 的一个段落。
- 场景的项目符号列表(S-N · 标题 · 锚点)。
- 分页。
**源文本。**
- 标题 1:"The [Statute/Contract/Regulation/Opinion]"(用 `meta.profile` 选择正确的名词)
- 将 `source.name` 渲染为章节标题。
- 每个章节/子条款:标题样式(顶层用标题 2,子级用标题 3),然后是文本。条款标签(如"(b)(7)")加粗。
- 对有锚定场景的条款,在条款末尾添加脚注列出攻击它的场景:"Scenarios: S-1, S-2, S-3."
- 分页。
**场景。**
- 标题 1:"The N Fights" 或 "The N Scenarios"(按数量用单数/复数)。
- 每个场景:
- 标题 2:"S-N · {title}"
- 斜体标签行段落。
- 加粗"Situation:"标签,然后是 `situation` 文本。
- **两列表格**用于立场:两列、单行。第 1 列:立场 A 表头(加粗彩色文本——用 `design.dept_color`)、斜体主体名、然后是论证。第 2 列:立场 B 相同。表格边框柔和。这是网站双立场面板的视觉等价物。
- 加粗"Weak point:"标签,然后是文本。
- 加粗"Likely outcome:"标签,然后是文本。
- **改写文本块:** 单行单单元格表格,浅黄色背景,斜体正文。上方"Proposed amendment"小型大写标签。
- 锚点标签作为内联文本:"Anchored to: §(b)(7)"。类别标签作为斜体文本:"*Defect family: Scope / coverage*"。
- 水平线。
- 如果前一个场景延伸超过页中位置,则每个新场景前分页。
**改写文本附录。**
- 标题 1:"Proposed Amendments"
- 解释该组合的简短段落。
- 每个场景的改写文本:
- 标题 2:"R-N · {short title} — amends {anchor}"
- 问题段落(从弱点或简短摘要推导)。
- **提案块**采用相同的黄边框表格样式。
- 交叉引用回场景:"See S-N."
- 分页。
**覆盖清单附录(如存在 `coverage_list`)。**
- 标题 1:"Additional ambiguities flagged"
- 简短引言。
- 每项作为项目符号:粗体标签,然后是说明。
**方法论附录(如存在 `methodology`)。**
- 标题 1:"Methodology"
- `methodology` 中的每个章节,一个带章节名的标题 2,然后是段落。
- 结尾以小型斜体行呈现来源行。
## 样式选择
**字体排印。** 使用 Word 的内置标题样式(Title、Heading 1、Heading 2、Heading 3、Normal)。修改底层样式而非直接格式化——这使文档在 Word 大纲视图中可导航,并允许用户通过更改样式来重新设置格式。
**标题样式覆盖。** 在 Word 允许的范围内匹配网站的字体排印感觉:
- 标题:衬线体(Georgia 或 Cambria),32pt,颜色 = `meta.title` 强调色(轻微着色,不是黑色)。
- 标题 1:衬线体,24pt,半粗。
- 标题 2:衬线体,18pt,常规。
- 标题 3:衬线体,14pt,半粗。
- 正文:无衬线体(Calibri,如有 Inter),11pt。
**颜色。** 立场 A 表头用 `design.dept_color` 渲染。立场 B 表头用 `design.adv_color` 渲染。将这些作为字体颜色应用于表格表头。背景:保持表格无边框或带非常浅的灰边框;每个单元格顶部的彩色色带标示阵营。
**锚点标签。** 在 Word 中,渲染为带细微背景底纹的小号内联文本。至少使用 Word 的字符高亮;更好:内联的单行单单元格表格。保持简单。
**类别标签。** 类似——小号内联斜体彩色文本。如果公开了 `design.family_palette` 则使用其中的类别颜色,否则用默认值。
## 改写文本的修订追踪
如果文档面向将谈判改写文本的起草人,使用 Word 的修订追踪功能:将拟议修改文本作为归属于"Ambiguity Audit"的追踪插入插入。这使改写文本在视觉上独特,并让起草人在常规流程中接受/拒绝。
是否使用修订追踪由用户选择——如果用户是将参与谈判的起草人,询问之。默认关闭;黄边框醒目框对审阅已足够。
## 交叉引用
Word 通过书签支持交叉引用。在每个场景标题(`scenario_N`)和每个改写文本标题(`redraft_N`)处设置书签。"See S-N" 链接使用这些书签,点击即可跳转到目标。源文本条款同样——按 ID 为每条条款设书签,让场景引用跳转到源文本。
## 页面设置
- 页边距:四周 1 英寸。
- 页码:右下角。
- 页眉:`meta.title` 小型大写,左对齐。
- 页脚:`meta.audit_date`,右对齐。
## 保存
在输出目录中保存为 `report.docx`。如果用户提供了特定文件名,遵从之。
## 常见需求
**"只要场景,不要源文本,不要附录。"** 跳过源文本部分和方法论/改写文本附录。生成更精简的简报。
**"将改写文本作为单独文档。"** 生成两个文件:`report.docx`(分析)和 `redrafts.docx`(仅修改包,按立法提交格式排版)。
**"按 CLE 讲义格式。"** 精简结构——单栏,立场不用两列表格(改用内联标签),字体更大。向用户说明渲染会不那么视觉丰富。
## 此格式擅长的
Word 是修订追踪审阅、边注评论和可打印交接的自然媒介。当接收方将在 Word 中阅读、批注或打印时,该格式最佳。
## 此格式不擅长的
Word 不擅长高度交互的内容。没有网站点击过滤或单页应用交叉高亮的对应物。将 Word 文档视为*快照*——网站用于探索,文档用于交付。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| canvas-designanthropics/skillsCreate beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| docxanthropics/skillsUse this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| pdfanthropics/skillsUse this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| pptxanthropics/skillsUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the user mentions "deck," "slides," "presentation," or references a .pptx or .potx filename, regardless of what they plan to do with the content afterward. If a .pptx or .potx file needs to be opened, created, or touched, use this skill. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |