pdd-skills 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (261) hide show
  1. package/README.md +1478 -0
  2. package/bin/pdd.js +354 -0
  3. package/config/bpmn-rules.yaml +166 -0
  4. package/config/checkstyle.xml +105 -0
  5. package/config/eslint.config.js +48 -0
  6. package/config/pmd.xml +91 -0
  7. package/config/prd-rules.yaml +113 -0
  8. package/config/ruff.toml +45 -0
  9. package/config/sqlfluff.cfg +82 -0
  10. package/hooks/hook-executor.js +332 -0
  11. package/index.js +43 -0
  12. package/lib/api-routes.js +750 -0
  13. package/lib/api-server.js +408 -0
  14. package/lib/cache/cache-config.js +209 -0
  15. package/lib/cache/system-cache.js +852 -0
  16. package/lib/config-manager.js +373 -0
  17. package/lib/generate.js +528 -0
  18. package/lib/grpc/grpc-routes.js +1134 -0
  19. package/lib/grpc/grpc-server.js +912 -0
  20. package/lib/grpc/proto-definitions.js +1033 -0
  21. package/lib/init.js +172 -0
  22. package/lib/iteration/auto-fixer.js +1025 -0
  23. package/lib/iteration/auto-reviewer.js +923 -0
  24. package/lib/iteration/controller.js +577 -0
  25. package/lib/list.js +130 -0
  26. package/lib/mcp-server.js +548 -0
  27. package/lib/openclaw/api-integration.js +535 -0
  28. package/lib/openclaw/cli-integration.js +567 -0
  29. package/lib/openclaw/data-sync.js +845 -0
  30. package/lib/openclaw/openclaw-adapter.js +783 -0
  31. package/lib/plugin/example-plugins/code-stats/index.js +332 -0
  32. package/lib/plugin/example-plugins/code-stats/plugin.json +1 -0
  33. package/lib/plugin/example-plugins/custom-linter/index.js +472 -0
  34. package/lib/plugin/example-plugins/custom-linter/plugin.json +1 -0
  35. package/lib/plugin/example-plugins/hello-world/index.js +86 -0
  36. package/lib/plugin/example-plugins/hello-world/plugin.json +1 -0
  37. package/lib/plugin/plugin-manager.js +655 -0
  38. package/lib/plugin/plugin-sdk.js +565 -0
  39. package/lib/plugin/sandbox.js +627 -0
  40. package/lib/quality/rules/maintainability.js +418 -0
  41. package/lib/quality/rules/performance.js +498 -0
  42. package/lib/quality/rules/readability.js +441 -0
  43. package/lib/quality/rules/robustness.js +504 -0
  44. package/lib/quality/rules/security.js +444 -0
  45. package/lib/quality/scorer.js +576 -0
  46. package/lib/report.js +669 -0
  47. package/lib/sdk-base.js +301 -0
  48. package/lib/sdk-js.js +446 -0
  49. package/lib/sdk-python/README.md +546 -0
  50. package/lib/sdk-python/examples/basic_usage.py +450 -0
  51. package/lib/sdk-python/pdd_sdk/__init__.py +180 -0
  52. package/lib/sdk-python/pdd_sdk/client.py +1170 -0
  53. package/lib/sdk-python/pdd_sdk/events.py +423 -0
  54. package/lib/sdk-python/pdd_sdk/exceptions.py +158 -0
  55. package/lib/sdk-python/pdd_sdk/models.py +518 -0
  56. package/lib/sdk-python/pdd_sdk/utils.py +759 -0
  57. package/lib/token/budget-alert.js +367 -0
  58. package/lib/token/budget-manager.js +485 -0
  59. package/lib/update.js +54 -0
  60. package/lib/utils/logger.js +88 -0
  61. package/lib/verify.js +741 -0
  62. package/lib/version.js +52 -0
  63. package/lib/vm/README.md +102 -0
  64. package/lib/vm/dashboard/api-routes.js +669 -0
  65. package/lib/vm/dashboard/server.js +391 -0
  66. package/lib/vm/dashboard/sse.js +358 -0
  67. package/lib/vm/dashboard/static/css/dashboard.css +1378 -0
  68. package/lib/vm/dashboard/static/index.html +118 -0
  69. package/lib/vm/dashboard/static/js/app.js +949 -0
  70. package/lib/vm/dashboard/static/js/charts.js +913 -0
  71. package/lib/vm/dashboard/static/js/kanban-view.js +1053 -0
  72. package/lib/vm/dashboard/static/js/pipeline-view.js +463 -0
  73. package/lib/vm/dashboard/static/js/quality-view.js +598 -0
  74. package/lib/vm/dashboard/static/js/system-view.js +1021 -0
  75. package/lib/vm/data-provider.js +1191 -0
  76. package/lib/vm/event-bus.js +402 -0
  77. package/lib/vm/hooks/extract-hook.js +307 -0
  78. package/lib/vm/hooks/generate-hook.js +374 -0
  79. package/lib/vm/hooks/hook-interface.js +458 -0
  80. package/lib/vm/hooks/report-hook.js +331 -0
  81. package/lib/vm/hooks/verify-hook.js +454 -0
  82. package/lib/vm/models.js +1003 -0
  83. package/lib/vm/reconciler.js +855 -0
  84. package/lib/vm/scanner.js +988 -0
  85. package/lib/vm/state-schema.js +955 -0
  86. package/lib/vm/state-store.js +733 -0
  87. package/lib/vm/tui/components/card.js +339 -0
  88. package/lib/vm/tui/components/progress-bar.js +368 -0
  89. package/lib/vm/tui/components/sparkline.js +327 -0
  90. package/lib/vm/tui/components/status-light.js +294 -0
  91. package/lib/vm/tui/components/table.js +370 -0
  92. package/lib/vm/tui/input.js +335 -0
  93. package/lib/vm/tui/renderer.js +548 -0
  94. package/lib/vm/tui/screens/kanban-screen.js +397 -0
  95. package/lib/vm/tui/screens/overview-screen.js +357 -0
  96. package/lib/vm/tui/screens/quality-screen.js +336 -0
  97. package/lib/vm/tui/screens/system-screen.js +379 -0
  98. package/lib/vm/tui/tui.js +805 -0
  99. package/package.json +1 -0
  100. package/scripts/cso-analyzer.js +198 -0
  101. package/scripts/eval-runner.js +359 -0
  102. package/scripts/i18n-checker.js +109 -0
  103. package/scripts/linter/activiti-linter.js +272 -0
  104. package/scripts/linter/prd-linter.js +162 -0
  105. package/scripts/linter/report-generator.js +207 -0
  106. package/scripts/linter/run-linters.js +285 -0
  107. package/scripts/linter/sql-linter.js +166 -0
  108. package/scripts/token-analyzer.js +162 -0
  109. package/scripts/vm-test.js +180 -0
  110. package/skills/core/official-doc-writer/LICENSE +21 -0
  111. package/skills/core/official-doc-writer/README.md +232 -0
  112. package/skills/core/official-doc-writer/SKILL.md +475 -0
  113. package/skills/core/official-doc-writer/_meta.json +1 -0
  114. package/skills/core/official-doc-writer/document_generator.py +580 -0
  115. package/skills/core/official-doc-writer/evals/default-evals.json +1 -0
  116. package/skills/core/official-doc-writer/examples.md +150 -0
  117. package/skills/core/official-doc-writer/fonts/FONTS_LIST.md +45 -0
  118. package/skills/core/official-doc-writer/fonts/README.md +141 -0
  119. package/skills/core/official-doc-writer/fonts/SIMFANG.TTF +0 -0
  120. package/skills/core/official-doc-writer/fonts/SIMHEI.TTF +0 -0
  121. package/skills/core/official-doc-writer/fonts/SIMKAI.TTF +0 -0
  122. package/skills/core/official-doc-writer/fonts/SIMSUN.TTC +0 -0
  123. package/skills/core/official-doc-writer/fonts//346/226/271/346/255/243/345/260/217/346/240/207/345/256/213GBK.TTF +0 -0
  124. package/skills/core/official-doc-writer/references/GBT_9704-2012_/345/205/232/346/224/277/346/234/272/345/205/263/345/205/254/346/226/207/346/240/274/345/274/217.md +422 -0
  125. package/skills/core/official-doc-writer/scripts/__pycache__/generate_official_doc.cpython-313.pyc +0 -0
  126. package/skills/core/official-doc-writer/scripts/dialog_manager.py +564 -0
  127. package/skills/core/official-doc-writer/scripts/generate_official_doc.py +252 -0
  128. package/skills/core/official-doc-writer/scripts/install_fonts.py +390 -0
  129. package/skills/core/official-doc-writer/scripts/smart_prompts.py +363 -0
  130. package/skills/core/pdd-ba/SKILL.md +305 -0
  131. package/skills/core/pdd-ba/_meta.json +1 -0
  132. package/skills/core/pdd-ba/evals/default-evals.json +1 -0
  133. package/skills/core/pdd-code-reviewer/SKILL.md +378 -0
  134. package/skills/core/pdd-code-reviewer/_meta.json +1 -0
  135. package/skills/core/pdd-code-reviewer/evals/default-evals.json +1 -0
  136. package/skills/core/pdd-doc-change/SKILL.md +350 -0
  137. package/skills/core/pdd-doc-change/_meta.json +1 -0
  138. package/skills/core/pdd-doc-change/evals/default-evals.json +1 -0
  139. package/skills/core/pdd-doc-gardener/SKILL.md +248 -0
  140. package/skills/core/pdd-doc-gardener/_meta.json +1 -0
  141. package/skills/core/pdd-doc-gardener/evals/default-evals.json +1 -0
  142. package/skills/core/pdd-entropy-reduction/SKILL.md +360 -0
  143. package/skills/core/pdd-entropy-reduction/_meta.json +1 -0
  144. package/skills/core/pdd-entropy-reduction/evals/default-evals.json +1 -0
  145. package/skills/core/pdd-entropy-reduction/references/entropy-report-template.md +287 -0
  146. package/skills/core/pdd-entropy-reduction/references/golden-principles.md +573 -0
  147. package/skills/core/pdd-entropy-reduction/scripts/entropy_scan.py +712 -0
  148. package/skills/core/pdd-extract-features/SKILL.md +320 -0
  149. package/skills/core/pdd-extract-features/_meta.json +1 -0
  150. package/skills/core/pdd-extract-features/evals/default-evals.json +1 -0
  151. package/skills/core/pdd-generate-spec/SKILL.md +418 -0
  152. package/skills/core/pdd-generate-spec/_meta.json +1 -0
  153. package/skills/core/pdd-generate-spec/evals/default-evals.json +1 -0
  154. package/skills/core/pdd-implement-feature/SKILL.md +332 -0
  155. package/skills/core/pdd-implement-feature/_meta.json +1 -0
  156. package/skills/core/pdd-implement-feature/evals/default-evals.json +1 -0
  157. package/skills/core/pdd-main/SKILL.md +540 -0
  158. package/skills/core/pdd-main/_meta.json +1 -0
  159. package/skills/core/pdd-main/evals/default-evals.json +1 -0
  160. package/skills/core/pdd-main/evals/evals.json +215 -0
  161. package/skills/core/pdd-verify-feature/SKILL.md +474 -0
  162. package/skills/core/pdd-verify-feature/_meta.json +1 -0
  163. package/skills/core/pdd-verify-feature/evals/default-evals.json +1 -0
  164. package/skills/core/pdd-vm/evals/default-evals.json +1 -0
  165. package/skills/core/traffic-accident-assessor/LICENSE +29 -0
  166. package/skills/core/traffic-accident-assessor/SKILL.md +439 -0
  167. package/skills/core/traffic-accident-assessor/evals/evals.json +1 -0
  168. package/skills/core/traffic-accident-assessor/references/accident-types.md +369 -0
  169. package/skills/core/traffic-accident-assessor/references/liability-rules.md +287 -0
  170. package/skills/core/traffic-accident-assessor/references/traffic-laws.md +226 -0
  171. package/skills/core/traffic-accident-assessor/references//351/253/230/345/260/224/345/244/253/350/257/264/346/230/216/344/271/246.pdf +32576 -106
  172. package/skills/core/traffic-accident-assessor/scripts/generate_official_statement.py +588 -0
  173. package/skills/core/traffic-accident-assessor/scripts/generate_report.py +495 -0
  174. package/skills/core/traffic-accident-assessor/scripts/generate_statement.py +528 -0
  175. package/skills/core/traffic-accident-assessor.zip +0 -0
  176. package/skills/entropy/expert-arch-enforcer/SKILL.md +292 -0
  177. package/skills/entropy/expert-arch-enforcer/_meta.json +1 -0
  178. package/skills/entropy/expert-arch-enforcer/evals/default-evals.json +1 -0
  179. package/skills/entropy/expert-auto-refactor/SKILL.md +327 -0
  180. package/skills/entropy/expert-auto-refactor/_meta.json +1 -0
  181. package/skills/entropy/expert-auto-refactor/evals/default-evals.json +1 -0
  182. package/skills/entropy/expert-code-quality/SKILL.md +468 -0
  183. package/skills/entropy/expert-code-quality/_meta.json +1 -0
  184. package/skills/entropy/expert-code-quality/evals/default-evals.json +1 -0
  185. package/skills/entropy/expert-code-quality/evals/evals.json +109 -0
  186. package/skills/entropy/expert-code-quality/references/code-smells.md +605 -0
  187. package/skills/entropy/expert-code-quality/references/design-patterns.md +1111 -0
  188. package/skills/entropy/expert-code-quality/references/refactoring-catalog.md +1281 -0
  189. package/skills/entropy/expert-code-quality/references/solid-principles.md +524 -0
  190. package/skills/entropy/expert-entropy-auditor/SKILL.md +276 -0
  191. package/skills/entropy/expert-entropy-auditor/_meta.json +1 -0
  192. package/skills/entropy/expert-entropy-auditor/evals/default-evals.json +1 -0
  193. package/skills/expert/expert-activiti/SKILL.md +497 -0
  194. package/skills/expert/expert-activiti/_meta.json +1 -0
  195. package/skills/expert/expert-mysql/SKILL.md +832 -0
  196. package/skills/expert/expert-mysql/_meta.json +1 -0
  197. package/skills/expert/expert-performance/SKILL.md +379 -0
  198. package/skills/expert/expert-performance/_meta.json +1 -0
  199. package/skills/expert/expert-performance/evals/default-evals.json +1 -0
  200. package/skills/expert/expert-ruoyi/SKILL.md +472 -0
  201. package/skills/expert/expert-ruoyi/_meta.json +1 -0
  202. package/skills/expert/expert-security/SKILL.md +1341 -0
  203. package/skills/expert/expert-security/_meta.json +1 -0
  204. package/skills/expert/expert-security/evals/default-evals.json +1 -0
  205. package/skills/expert/software-architect/SKILL.md +350 -0
  206. package/skills/expert/software-architect/_meta.json +1 -0
  207. package/skills/expert/software-engineer/SKILL.md +437 -0
  208. package/skills/expert/software-engineer/_meta.json +1 -0
  209. package/skills/expert/software-engineer/architecture.md +130 -0
  210. package/skills/expert/software-engineer/patterns.md +151 -0
  211. package/skills/expert/software-engineer/testing.md +135 -0
  212. package/skills/expert/system-architect/SKILL.md +628 -0
  213. package/skills/expert/system-architect/_meta.json +1 -0
  214. package/skills/expert/system-architect/assets/templates/ARCHITECTURE.md +25 -0
  215. package/skills/expert/system-architect/assets/templates/README.md +44 -0
  216. package/skills/expert/system-architect/references/js-ts-standards.md +18 -0
  217. package/skills/expert/system-architect/references/python-standards.md +19 -0
  218. package/skills/expert/system-architect/references/scaffolding.md +61 -0
  219. package/skills/expert/system-architect/references/security-checklist.md +21 -0
  220. package/skills/openspec/openspec-apply-change/SKILL.md +156 -0
  221. package/skills/openspec/openspec-apply-change/_meta.json +1 -0
  222. package/skills/openspec/openspec-archive-change/SKILL.md +114 -0
  223. package/skills/openspec/openspec-archive-change/_meta.json +1 -0
  224. package/skills/openspec/openspec-bulk-archive-change/SKILL.md +246 -0
  225. package/skills/openspec/openspec-bulk-archive-change/_meta.json +1 -0
  226. package/skills/openspec/openspec-continue-change/SKILL.md +118 -0
  227. package/skills/openspec/openspec-continue-change/_meta.json +1 -0
  228. package/skills/openspec/openspec-explore/SKILL.md +288 -0
  229. package/skills/openspec/openspec-explore/_meta.json +1 -0
  230. package/skills/openspec/openspec-ff-change/SKILL.md +101 -0
  231. package/skills/openspec/openspec-ff-change/_meta.json +1 -0
  232. package/skills/openspec/openspec-new-change/SKILL.md +74 -0
  233. package/skills/openspec/openspec-new-change/_meta.json +1 -0
  234. package/skills/openspec/openspec-onboard/SKILL.md +554 -0
  235. package/skills/openspec/openspec-onboard/_meta.json +1 -0
  236. package/skills/openspec/openspec-sync-specs/SKILL.md +138 -0
  237. package/skills/openspec/openspec-sync-specs/_meta.json +1 -0
  238. package/skills/openspec/openspec-verify-change/SKILL.md +168 -0
  239. package/skills/openspec/openspec-verify-change/_meta.json +1 -0
  240. package/skills/pr/pdd-multi-review/SKILL.md +534 -0
  241. package/skills/pr/pdd-multi-review/_meta.json +1 -0
  242. package/skills/pr/pdd-pr-batch/SKILL.md +303 -0
  243. package/skills/pr/pdd-pr-batch/_meta.json +1 -0
  244. package/skills/pr/pdd-pr-create/SKILL.md +344 -0
  245. package/skills/pr/pdd-pr-create/_meta.json +1 -0
  246. package/skills/pr/pdd-pr-merge/SKILL.md +286 -0
  247. package/skills/pr/pdd-pr-merge/_meta.json +1 -0
  248. package/skills/pr/pdd-pr-review/SKILL.md +217 -0
  249. package/skills/pr/pdd-pr-review/_meta.json +1 -0
  250. package/skills/pr/pdd-task-manager/SKILL.md +636 -0
  251. package/skills/pr/pdd-task-manager/_meta.json +1 -0
  252. package/skills/pr/pdd-template-engine/SKILL.md +306 -0
  253. package/skills/pr/pdd-template-engine/_meta.json +1 -0
  254. package/templates/behavior-shaping/iron-law-template.md +87 -0
  255. package/templates/behavior-shaping/rationalization-template.md +62 -0
  256. package/templates/behavior-shaping/red-flags-template.md +70 -0
  257. package/templates/bilingual-template.md +139 -0
  258. package/templates/config/default.yaml +47 -0
  259. package/templates/project/default/README.md +31 -0
  260. package/templates/project/frontend/README.md +46 -0
  261. package/templates/project/java/README.md +48 -0
@@ -0,0 +1,495 @@
1
+ # -*- coding: utf-8 -*-
2
+ """
3
+ 交通事故责任评估报告 - Word文档生成器
4
+ 生成包含照片、专业排版、法律引用的完整评估报告
5
+ """
6
+
7
+ import os
8
+ import sys
9
+ from datetime import datetime
10
+ from docx import Document
11
+ from docx.shared import Inches, Pt, Cm, RGBColor
12
+ from docx.enum.text import WD_ALIGN_PARAGRAPH
13
+ from docx.enum.table import WD_TABLE_ALIGNMENT
14
+ from docx.enum.style import WD_STYLE_TYPE
15
+ from docx.oxml.ns import qn, nsdecls
16
+ from docx.oxml import parse_xml
17
+
18
+
19
+ def set_cell_shading(cell, color):
20
+ """设置单元格背景色"""
21
+ shading = parse_xml(f'<w:shd {nsdecls("w")} w:fill="{color}"/>')
22
+ cell._tc.get_or_add_tcPr().append(shading)
23
+
24
+
25
+ def add_heading_with_style(doc, text, level=1, color=None):
26
+ """添加带样式的标题"""
27
+ heading = doc.add_heading(text, level=level)
28
+ if color:
29
+ for run in heading.runs:
30
+ run.font.color.rgb = color
31
+ return heading
32
+
33
+
34
+ def create_info_table(doc, data):
35
+ """创建信息表格"""
36
+ table = doc.add_table(rows=len(data), cols=2)
37
+ table.style = 'Table Grid'
38
+ table.autofit = True
39
+ for i, (key, value) in enumerate(data):
40
+ row = table.rows[i]
41
+ row.cells[0].text = key
42
+ row.cells[1].text = value
43
+ # 设置表头样式(第一行加粗背景)
44
+ if i == 0:
45
+ for cell in row.cells:
46
+ set_cell_shading(cell, "E8F4FD")
47
+ for p in cell.paragraphs:
48
+ for run in p.runs:
49
+ run.font.bold = True
50
+ run.font.size = Pt(11)
51
+ else:
52
+ for cell in row.cells:
53
+ for p in cell.paragraphs:
54
+ for run in p.runs:
55
+ run.font.size = Pt(10)
56
+ return table
57
+
58
+
59
+ def add_legal_quote(doc, article_num, title, content, note=""):
60
+ """添加法律条文引用块"""
61
+ # 条款标题
62
+ p = doc.add_paragraph()
63
+ run_title = p.add_run(f"◆ 第{article_num}条 【{title}】")
64
+ run_title.bold = True
65
+ run_title.font.color.rgb = RGBColor(0x1A, 0x56, 0xDB)
66
+ run_title.font.size = Pt(11)
67
+
68
+ # 引用内容(缩进+灰色背景效果通过边框模拟)
69
+ p2 = doc.add_paragraph()
70
+ run_content = p2.add_run(f' "{content}"')
71
+ run_content.italic = True
72
+ run_content.font.size = Pt(10)
73
+ run_content.font.color.rgb = RGBColor(0x33, 0x33, 0x33)
74
+
75
+ # 适用说明
76
+ if note:
77
+ p3 = doc.add_paragraph()
78
+ run_note = p3.add_run(f" ▸ 适用说明:{note}")
79
+ run_note.font.size = Pt(9.5)
80
+ run_note.font.color.rgb = RGBColor(0x66, 0x66, 0x66)
81
+
82
+
83
+ def add_warning_box(doc, text):
84
+ """添加警告/免责框"""
85
+ p = doc.add_paragraph()
86
+ run = p.add_run(f"⚠ {text}")
87
+ run.bold = True
88
+ run.font.size = Pt(10)
89
+ run.font.color.rgb = RGBColor(0xD4, 0x73, 0x13)
90
+
91
+
92
+ def generate_report(output_path, image_paths=None):
93
+ """生成完整评估报告"""
94
+
95
+ doc = Document()
96
+
97
+ # ========== 页面设置 ==========
98
+ section = doc.sections[0]
99
+ section.page_width = Cm(21)
100
+ section.page_height = Cm(29.7)
101
+ section.left_margin = Cm(2.5)
102
+ section.right_margin = Cm(2.5)
103
+ section.top_margin = Cm(2.5)
104
+ section.bottom_margin = Cm(2.5)
105
+
106
+ # ==================== 封面标题 ====================
107
+ title = doc.add_heading('交通事故责任评估报告', 0)
108
+ title.alignment = WD_ALIGN_PARAGRAPH.CENTER
109
+ for run in title.runs:
110
+ run.font.size = Pt(26)
111
+ run.font.color.rgb = RGBColor(0x1A, 0x23, 0x7E)
112
+ run.font.bold = True
113
+
114
+ subtitle = doc.add_paragraph()
115
+ subtitle.alignment = WD_ALIGN_PARAGRAPH.CENTER
116
+ run_sub = subtitle.add_run('Traffic Accident Liability Assessment Report')
117
+ run_sub.font.size = Pt(14)
118
+ run_sub.font.color.rgb = RGBColor(0x88, 0x88, 0x88)
119
+ run_sub.italic = True
120
+
121
+ doc.add_paragraph()
122
+
123
+ # 报告元信息表格
124
+ meta_data = [
125
+ ("评估编号", "TAA-20260404-001"),
126
+ ("评估日期", datetime.now().strftime("%Y年%m月%d日")),
127
+ ("事故类型", "机动车之间 · 丁字路口碰撞(转弯 vs 直行)"),
128
+ ("事故地点", "城市道路 · 无信号灯丁字路口(近中海·云麓里)"),
129
+ ("天气条件", "晴朗 · 能见度良好 · 白天"),
130
+ ]
131
+ create_info_table(doc, meta_data)
132
+ doc.add_paragraph()
133
+
134
+ # ==================== 一、事故经过概述 ====================
135
+ doc.add_heading('一、事故经过概述', level=1)
136
+
137
+ overview_text = """当事人甲(金色大众高尔夫,车牌号 辽A·87FG5)驾驶车辆由南向北行驶至一处无红绿灯控制的丁字路口时向左转弯。此时,当事人乙(灰色SUV,疑似奥迪电动SUV)沿横向道路直行通过该路口。两车在路口区域内发生碰撞,乙车前部撞击甲车右侧副驾驶位车门区域,造成甲车右后门车窗破碎、右侧车身严重凹陷,气囊弹出。"""
138
+ p = doc.add_paragraph(overview_text)
139
+ p.paragraph_format.first_line_indent = Cm(0.75)
140
+ p.paragraph_format.line_spacing = 1.5
141
+
142
+ # ==================== 二、现场照片分析 ====================
143
+ doc.add_heading('二、现场照片分析', level=1)
144
+
145
+ photo_descriptions = [
146
+ {
147
+ "title": "照片1 — 碰撞部位特写",
148
+ "desc": """关键发现:
149
+ • 甲车损伤位置:右侧车身(副驾驶门/B柱/右后门区域),右后侧窗完全破碎
150
+ • 乙车损伤位置:前部右侧(前保险杠右端/右前翼子板/右前轮区域)
151
+ • 碰撞形态:T型碰撞(T-bone),乙车前右 → 甲车右侧
152
+ • 判定意义:确认甲车处于横穿状态(侧面受撞),符合"转弯车切入直行车路径"的典型碰撞模式""",
153
+ },
154
+ {
155
+ "title": "照片2 — 全景照(角度一)",
156
+ "desc": """关键发现:
157
+ • 两车最终位置:甲车呈明显偏转角度(约30°-45°),与"左转中"状态高度吻合
158
+ • 限速标志:远处可见限速50km/h标志牌
159
+ • 道路环境:多车道城市道路,高层住宅区背景(中海·云麓里)
160
+ • 天气条件:晴天,阳光强烈,视线条件极佳,排除天气因素影响""",
161
+ },
162
+ {
163
+ "title": "照片3 — 全景照(角度二)",
164
+ "desc": """关键发现:
165
+ • 甲车车牌清晰可辨:辽A·87FG5
166
+ • 路面标线:可见白色车道分隔线,属划设标线的正规道路
167
+ • 周边动态:有骑行电动车人员、远处其他车辆,该路口有一定交通流量
168
+ • 路口形态:开阔T型/十字路口区域,视距充足""",
169
+ },
170
+ {
171
+ "title": "照片4 — 后方视角",
172
+ "desc": """关键发现:
173
+ • 甲车尾部完整可见,车牌辽A·87FG5二次确认
174
+ • 乙车位于甲车左后方,两车呈夹角停靠(与碰撞后自然滑移规律一致)
175
+ • 周边环境:商业街区(绿源电动车店、蓝色经典等商铺)
176
+ • 目击人员:现场有多名围观群众,可能存在目击者""",
177
+ },
178
+ ]
179
+
180
+ for i, info in enumerate(photo_descriptions):
181
+ # 子标题
182
+ h = doc.add_heading(info["title"], level=2)
183
+ for run in h.runs:
184
+ run.font.color.rgb = RGBColor(0x2E, 0x7D, 0x32)
185
+
186
+ # 插入图片(如果有)
187
+ if image_paths and i < len(image_paths) and os.path.exists(image_paths[i]):
188
+ img_path = image_paths[i]
189
+ try:
190
+ doc.add_picture(img_path, width=Inches(5.5))
191
+ last_para = doc.paragraphs[-1]
192
+ last_para.alignment = WD_ALIGN_PARAGRAPH.CENTER
193
+ caption = doc.add_paragraph(f"图{i+1}: {info['title']}")
194
+ caption.alignment = WD_ALIGN_PARAGRAPH.CENTER
195
+ for run in caption.runs:
196
+ run.font.size = Pt(9)
197
+ run.font.color.rgb = RGBColor(0x88, 0x88, 0x88)
198
+ run.italic = True
199
+ except Exception as e:
200
+ doc.add_paragraph(f"[图片加载失败: {e}]")
201
+ else:
202
+ # 占位提示
203
+ p_placeholder = doc.add_paragraph()
204
+ p_placeholder.alignment = WD_ALIGN_PARAGRAPH.CENTER
205
+ run_ph = p_placeholder.add_run(f"[{info['title']} — 请手动插入对应照片]")
206
+ run_ph.font.color.rgb = RGBColor(0xAA, 0xAA, 0xAA)
207
+ run_ph.italic = True
208
+
209
+ # 分析描述
210
+ desc_p = doc.add_paragraph(info["desc"])
211
+ desc_p.paragraph_format.left_indent = Cm(0.5)
212
+
213
+ doc.add_paragraph()
214
+
215
+ # 综合结论框
216
+ doc.add_heading('📌 照片证据链综合结论', level=2)
217
+ conclusion_p = doc.add_paragraph()
218
+ conclusion_p.paragraph_format.left_indent = Cm(0.5)
219
+ conclusion_p.paragraph_format.right_indent = Cm(0.5)
220
+ run_c = conclusion_p.add_run(
221
+ '四张照片共同构成的证据链一致指向同一事实 —— '
222
+ '您的车辆在左转过程中被直行车辆从侧面撞击。'
223
+ '碰撞形态(T型)、车辆最终位置(偏转角度)、受损部位(右侧车门区域)'
224
+ '三者相互印证,完全符合"转弯车未让直行车"的事故类型特征。'
225
+ )
226
+ run_c.font.size = Pt(10.5)
227
+ run_c.bold = True
228
+
229
+ # ASCII态势图
230
+ doc.add_paragraph()
231
+ diagram = doc.add_paragraph()
232
+ diagram.alignment = WD_ALIGN_PARAGRAPH.CENTER
233
+ run_diag = diagram.add_run("""
234
+ ┌─────────────────────────┐
235
+ │ 【北】 │
236
+ │ ↑ │
237
+ │ │ 甲车(金) │
238
+ │ │ ↖ 左转中 │
239
+ │ │ ╲ ← 碰撞点 │
240
+ └─────┬────┼──────┼────────┘
241
+ │ │ │
242
+ ←────┼── 乙车(灰) ──→
243
+ (直行) (直行)
244
+ [西] [东]
245
+
246
+ ★ T型碰撞:转弯车切入直行车路径 ★
247
+ """)
248
+ run_diag.font.name = "Consolas"
249
+ run_diag.font.size = Pt(9)
250
+
251
+ # ==================== 三、当事人行为分析 ====================
252
+ doc.add_heading('三、当事人行为分析', level=1)
253
+
254
+ # 当事人A表格
255
+ doc.add_heading('▶ 当事人A(您方 — 金色大众高尔夫 · 左转)', level=2)
256
+ table_a = doc.add_table(rows=6, cols=2)
257
+ table_a.style = 'Table Grid'
258
+ a_data = [
259
+ ("行为描述", "由南向北行驶至无信号灯丁字路口时执行左转操作,横穿横向道路"),
260
+ ("是否存在违法", "✅ 是 — 违反转弯车辆让行直行车辆的法定义务"),
261
+ ("违反法条", "《道路交通安全法实施条例》第52条第(三)项"),
262
+ ("过错程度", "高 — 转弯让直行是基本路权规则,未履行即构成对直行方路权的侵犯"),
263
+ ("因果测试", "若甲方不左转或待直行车辆通过后再转,事故不会发生 → 直接原因"),
264
+ ("过错分值参考", "6-7分(未按规定让行,参照过错量化矩阵)"),
265
+ ]
266
+ for i, (k, v) in enumerate(a_data):
267
+ table_a.rows[i].cells[0].text = k
268
+ table_a.rows[i].cells[1].text = v
269
+ if i == 0:
270
+ for cell in table_a.rows[i].cells:
271
+ set_cell_shading(cell, "FFF3CD")
272
+ for p in cell.paragraphs:
273
+ for run in p.runs:
274
+ run.bold = True
275
+ run.font.size = Pt(10)
276
+
277
+ doc.add_paragraph()
278
+
279
+ # 当事人B表格
280
+ doc.add_heading('▶ 当事人B(对方 — 灰色SUV · 直行)', level=2)
281
+ table_b = doc.add_table(rows=6, cols=2)
282
+ table_b.style = 'Table Grid'
283
+ b_data = [
284
+ ("行为描述", "沿横向道路直行通过丁字路口,与正在左转的甲车发生碰撞"),
285
+ ("是否存在违法", "⚠️ 初步判断无明显违法 — 直行车辆依法享有优先通行权"),
286
+ ("潜在审查事项", "①是否超过50km/h限速;②是否采取合理避让措施;③是否存在分心驾驶"),
287
+ ("过错程度", "低或无 — 直行方在无信号灯路口处于法律保护的优先地位"),
288
+ ("因果测试", "即使换为其他直行车辆,若甲方仍违规转弯,事故仍大概率发生 → 非必要原因"),
289
+ ("过错分值参考", "0-2分(如无超速等则为0分)"),
290
+ ]
291
+ for i, (k, v) in enumerate(b_data):
292
+ table_b.rows[i].cells[0].text = k
293
+ table_b.rows[i].cells[1].text = v
294
+ if i == 0:
295
+ for cell in table_b.rows[i].cells:
296
+ set_cell_shading(cell, "D4EDDA")
297
+ for p in cell.paragraphs:
298
+ for run in p.runs:
299
+ run.bold = True
300
+ run.font.size = Pt(10)
301
+
302
+ # ==================== 四、责任判定结论 ====================
303
+ doc.add_page_break()
304
+ doc.add_heading('四、责任判定结论', level=1)
305
+
306
+ # 判定结果总表
307
+ result_table = doc.add_table(rows=3, cols=4)
308
+ result_table.style = 'Table Grid'
309
+ headers = ["当事人", "车辆信息", "责任等级", "责任比例"]
310
+ for j, h in enumerate(headers):
311
+ result_table.rows[0].cells[j].text = h
312
+ set_cell_shading(result_table.rows[0].cells[j], "1A56DB")
313
+ for p in result_table.rows[0].cells[j].paragraphs:
314
+ p.alignment = WD_ALIGN_PARAGRAPH.CENTER
315
+ for run in p.runs:
316
+ run.bold = True
317
+ run.font.color.rgb = RGBColor(0xFF, 0xFF, 0xFF)
318
+ run.font.size = Pt(11)
319
+
320
+ # A方数据
321
+ result_table.rows[1].cells[0].text = "当事人A(您方)"
322
+ result_table.rows[1].cells[1].text = "金色大众高尔夫\n辽A·87FG5"
323
+ result_table.rows[1].cells[2].text = "主要责任"
324
+ result_table.rows[1].cells[3].text = "70% ~ 90%"
325
+ for cell in result_table.rows[1].cells:
326
+ set_cell_shading(cell, "FFE5E5")
327
+
328
+ # B方数据
329
+ result_table.rows[2].cells[0].text = "当事人B(对方)"
330
+ result_table.rows[2].cells[1].text = "灰色SUV"
331
+ result_table.rows[2].cells[2].text = "无责 ~ 次要"
332
+ result_table.rows[2].cells[3].text = "0% ~ 30%"
333
+ for cell in result_table.rows[2].cells:
334
+ set_cell_shading(cell, "E5F5E5")
335
+
336
+ doc.add_paragraph()
337
+
338
+ # 判定推理过程
339
+ doc.add_heading('判定推理过程', level=2)
340
+
341
+ steps = [
342
+ ("第一步 — 违法行为认定", "A方违反《实施条例》第52条第3项(转弯让直行);B方初步审查无违法。"),
343
+ ("第二步 — 因果关系分析(But-for测试)", "若A方不左转→事故不发生(直接原因,系数≈1.0);换任何直行车辆→事故仍发生(B方非原因)。"),
344
+ ("第三步 — 过错程度比较", "A方路权弱势、有明确让行义务、行为危险性高(6-7分);B方路权强势、一般安全义务即可(0-2分)。过错比 A:B ≈ 7:1 ~ 9:1。"),
345
+ ("第四步 — 综合评定", "第52条第3项确立刚性规则 → 转弯方负有法定让行义务 → 未履行 → 进入对方合法路径 → 无法避免碰撞 → 承担主要以上责任。"),
346
+ ]
347
+
348
+ for step_title, step_content in steps:
349
+ sp = doc.add_paragraph()
350
+ run_st = sp.add_run(f"● {step_title}\n {step_content}")
351
+ run_st.font.size = Pt(10.5)
352
+ sp.paragraph_format.left_indent = Cm(0.3)
353
+ sp.paragraph_format.space_after = Pt(8)
354
+
355
+ # ==================== 五、法律依据详列 ====================
356
+ doc.add_page_break()
357
+ doc.add_heading('五、法律依据详列', level=1)
358
+
359
+ # 道交法条文
360
+ doc.add_heading('《中华人民共和国道路交通安全法》', level=2)
361
+
362
+ add_legal_quote(doc, "38", "信号灯及通行原则",
363
+ "车辆、行人应当按照交通信号通行;遇有交通警察现场指挥时,应当按照交通警察的指挥通行;在没有交通信号的道路上,应当在确保安全、畅通的原则下通行。",
364
+ "无信号灯路口的基本通行原则——转弯车辆在未确保安全的情况下转弯即违反此条。")
365
+
366
+ doc.add_paragraph()
367
+
368
+ add_legal_quote(doc, "22", "安全驾驶义务",
369
+ "机动车驾驶人应当遵守道路交通安全法律、法规的规定,按照操作规范安全驾驶、文明驾驶。",
370
+ "转弯前的观察、减速、让行均属于'按操作规范安全驾驶'的具体要求。")
371
+
372
+ doc.add_paragraph()
373
+
374
+ # 实施条例(核心!)
375
+ doc.add_heading('《中华人民共和国道路交通安全法实施条例》★★★ 核心法条 ★★★', level=2)
376
+
377
+ add_legal_quote(doc, "52", "无信号灯路口通行规则",
378
+ "机动车通过没有交通信号灯控制也没有交通警察指挥的交叉路口,除应当遵守第五十一条第(二)项、第(三)项的规定外,还应当遵守下列规定:\n(一)有交通标志、标线控制的,让优先通行的一方先行;\n(二)没有交通标志、标线控制的,在进入路口前停车瞭望,让右方道路的来车先行;\n(三)转弯的机动车让直行的车辆先行;\n(四)相对方向行驶的右转弯的机动车让左转弯的车辆先行。",
379
+ "⭐ 第(三)项是本案的核心法律依据!'转弯的机动车让直行的车辆先行'是强制性规定,不是建议。违反此规定即构成违法,且通常与事故的发生具有直接因果关系。")
380
+
381
+ doc.add_paragraph()
382
+
383
+ add_legal_quote(doc, "51条第(七)项", "转弯让直行(有信号灯路口参照)",
384
+ "...(七)在没有方向指示信号灯的交叉路口,转弯的机动车让直行的车辆、行人通行。相对方向行驶的右转弯的机动车让左转弯的车辆先行。",
385
+ "体现立法者对'转弯让直行'规则的一贯态度,即使在有信号灯路口同样适用。")
386
+
387
+ doc.add_paragraph()
388
+
389
+ # 程序规定
390
+ doc.add_heading('《道路交通事故处理程序规定》(2020年修正)', level=2)
391
+
392
+ add_legal_quote(doc, "60", "责任认定标准",
393
+ "公安机关交通管理部门经过调查后,应当根据当事人的行为对发生道路交通事故所起的作用以及过错的严重程度,确定当事人的责任:(一)因一方当事人的过错导致道路交通事故的,承担全部责任;(二)因两方或者两方以上当事人的过错发生道路交通事故的,根据其行为对事故发生的作用以及过错的严重程度,分别承担主要责任、同等责任和次要责任...",
394
+ "本案适用第(二)项:A方过错起主要作用且程度较高 → 对应'主要责任'档次。")
395
+
396
+ # ==================== 六、法律建议 ====================
397
+ doc.add_page_break()
398
+ doc.add_heading('六、法律建议', level=1)
399
+
400
+ # 您方的建议
401
+ doc.add_heading('👤 对您方(转弯方 / 主要责任方)的建议', level=2)
402
+ your_advice = [
403
+ "配合交警调查,如实陈述事实 —— 不要隐瞒或歪曲事故经过,照片证据已清楚反映碰撞形态",
404
+ "主动争取减轻责任的因素 —— 如已提前开转向灯(≥3秒)、已部分进入路口后才被撞、对方明显超速等",
405
+ "立即联系保险公司报案 —— 车损由对方交强险先赔2000元,超出部分按责任比例分担;对方的损失由您的交强险+三者险赔付",
406
+ "保留所有单据 —— 气囊弹出意味着维修成本增加,如有人身伤害务必保留全部医疗单据",
407
+ "如对认定书不服 —— 可在收到认定书之日起3日内申请复核",
408
+ ]
409
+ for i, advice in enumerate(your_advice, 1):
410
+ p = doc.add_paragraph()
411
+ run = p.add_run(f"{i}. {advice}")
412
+ run.font.size = Pt(10.5)
413
+ p.paragraph_format.left_indent = Cm(0.3)
414
+
415
+ doc.add_paragraph()
416
+
417
+ # 对方的建议
418
+ doc.add_heading('👤 对对方(直行方)的建议', level=2)
419
+ their_advice = [
420
+ "主张无责论据 —— 强调正常直行中被转弯车辆切入路径,提供照片证明T型碰撞形态",
421
+ "如有行车记录仪视频 —— 这是最有力的证据",
422
+ "防范对方抗辩 —— 对方可能主张'已打转向灯'或'已转了一半',但这些不能免除让行义务",
423
+ ]
424
+ for i, advice in enumerate(their_advice, 1):
425
+ p = doc.add_paragraph()
426
+ run = p.add_run(f"{i}. {advice}")
427
+ run.font.size = Pt(10.5)
428
+ p.paragraph_format.left_indent = Cm(0.3)
429
+
430
+ # 后续流程
431
+ doc.add_heading('📋 后续处理流程', level=2)
432
+ flow = doc.add_paragraph()
433
+ flow_text = """
434
+ ① 交警现场勘查 → 等待《道路交通事故认定书》
435
+
436
+ ② 收到认定书 → 如不服可在3日内申请复核
437
+
438
+ ③ 责任确定后 → 双方保险公司介入理赔
439
+
440
+ ④ 协商赔偿 → 协不成则诉讼解决
441
+ """
442
+ run_flow = flow.add_run(flow_text)
443
+ run_flow.font.size = Pt(10.5)
444
+ flow.paragraph_format.left_indent = Cm(1)
445
+
446
+ # ==================== 七、免责声明 ====================
447
+ doc.add_page_break()
448
+ doc.add_heading('七、免责声明', level=1)
449
+
450
+ disclaimer_items = [
451
+ "本评估报告基于用户提供的文字描述和4张现场照片生成,仅供参考之用。",
452
+ "本报告不能替代公安机关交通管理部门出具的正式《道路交通事故认定书》,最终责任认定以交警部门的官方调查结论为准。",
453
+ "本分析未考虑以下可能影响判定的因素:是否有交通监控录像、是否有目击者证言、双方驾驶员是否存在酒驾/毒驾/无证驾驶、路面是否有特殊标志标线、具体车速鉴定结果等。",
454
+ "如对方车辆存在超速(超过50km/h限速20%以上)、分心驾驶或未尽合理观察义务等情况,责任比例可能向转弯方有利方向调整。",
455
+ "如涉及人身伤害或较大财产损失,建议及时委托专业律师处理后续理赔事宜。",
456
+ "本报告中引用的法律条文均为公开有效的法律法规内容。",
457
+ ]
458
+
459
+ for item in disclaimer_items:
460
+ dp = doc.add_paragraph()
461
+ run_dp = dp.add_run(f"⚠ {item}")
462
+ run_dp.font.size = Pt(10)
463
+ run_dp.font.color.rgb = RGBColor(0x55, 0x55, 0x55)
464
+
465
+ doc.add_paragraph()
466
+
467
+ # 页脚
468
+ footer_p = doc.add_paragraph()
469
+ footer_p.alignment = WD_ALIGN_PARAGRAPH.RIGHT
470
+ run_footer = footer_p.add_run(f"— — —\n生成时间:{datetime.now().strftime('%Y年%m月%d日 %H:%M')}\nTraffic Accident Assessor Skill v1.0")
471
+ run_footer.font.size = Pt(9)
472
+ run_footer.font.color.rgb = RGBColor(0xAA, 0xAA, 0xAA)
473
+ run_footer.italic = True
474
+
475
+ # 保存
476
+ doc.save(output_path)
477
+ print(f"✅ 报告已生成: {output_path}")
478
+ return output_path
479
+
480
+
481
+ if __name__ == "__main__":
482
+ output_file = r"c:\Users\wonder\trae-projects\skills\skills\traffic-accident-assessor\output\交通事故责任评估报告_辽A87FG5.docx"
483
+
484
+ # 确保输出目录存在
485
+ os.makedirs(os.path.dirname(output_file), exist_ok=True)
486
+
487
+ # 图片路径(如有实际图片则传入)
488
+ image_paths = [
489
+ r"c:\Users\wonder\trae-projects\skills\skills\traffic-accident-assessor\output\photo1.jpg",
490
+ r"c:\Users\wonder\trae-projects\skills\skills\traffic-accident-assessor\output\photo2.jpg",
491
+ r"c:\Users\wonder\trae-projects\skills\skills\traffic-accident-assessor\output\photo3.jpg",
492
+ r"c:\Users\wonder\trae-projects\skills\skills\traffic-accident-assessor\output\photo4.jpg",
493
+ ]
494
+
495
+ generate_report(output_file, image_paths)