alran 0.0.0-stage → 0.9.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 (506) hide show
  1. package/ALRAN_TOOLS_NOTICES.md +64 -0
  2. package/LICENSE +27 -0
  3. package/LICENSE-STATUS.md +21 -0
  4. package/NOTICE +6 -0
  5. package/README.md +289 -2
  6. package/THIRD_PARTY_NOTICES.md +113 -0
  7. package/alran-tools.js +3 -0
  8. package/assets/agents/_default/prompt-auto_classifier.md +185 -0
  9. package/assets/agents/_default/prompt-auto_classifier_extras.md +17 -0
  10. package/assets/agents/_default/prompt-base-all.md +133 -0
  11. package/assets/agents/_default/prompt-base-all.md.hbs +228 -0
  12. package/assets/agents/_default/prompt-base-windows.md +5 -0
  13. package/assets/agents/_default/prompt-base-windows.md.hbs +5 -0
  14. package/assets/agents/_default/prompt-base-worker.md +10 -0
  15. package/assets/agents/_default/prompt-base-worker.md.hbs +27 -0
  16. package/assets/agents/_default/prompt-compact.md +76 -0
  17. package/assets/agents/_default/prompt-compact_continue.md +9 -0
  18. package/assets/agents/_default/prompt-git.md +8 -0
  19. package/assets/agents/_default/prompt-goal.md +13 -0
  20. package/assets/agents/_default/prompt-session-branch.md +3 -0
  21. package/assets/agents/_default/prompt-session-branch.md.hbs +30 -0
  22. package/assets/agents/_default/prompt-session-root.md +3 -0
  23. package/assets/agents/_default/prompt-session-root.md.hbs +32 -0
  24. package/assets/agents/_default/prompt-title.md +11 -0
  25. package/assets/agents/_default/prompt-tool_agent.md +22 -0
  26. package/assets/agents/_migration/README.md +20 -0
  27. package/assets/agents/_migration/coder/PERSONA.md +11 -0
  28. package/assets/agents/_migration/coder/system-prompt.md.hbs +42 -0
  29. package/assets/agents/_migration/general/PERSONA.md +11 -0
  30. package/assets/agents/_migration/general/system-prompt.md.hbs +49 -0
  31. package/assets/agents/_v2/AGENT_CONTEXT.md.hbs +245 -0
  32. package/assets/agents/_v2/PTC_TOOL_CALLS.md.hbs +35 -0
  33. package/assets/agents/_v2/coding/SYSTEM.md.hbs +173 -0
  34. package/assets/agents/_v2/explore.md.hbs +38 -0
  35. package/assets/agents/_v2/tui/SYSTEM.md.hbs +211 -0
  36. package/assets/agents/_v2/verifier.md.hbs +32 -0
  37. package/assets/agents/_v2/work/SYSTEM.md.hbs +186 -0
  38. package/assets/agents/_v2/worker.md.hbs +27 -0
  39. package/assets/agents/alran/PERSONA.md +7 -0
  40. package/assets/agents/alran/features/cron.md.hbs +0 -0
  41. package/assets/agents/alran/features/delegation.md.hbs +56 -0
  42. package/assets/agents/alran/features/memory.md.hbs +61 -0
  43. package/assets/agents/alran/features/recoverable-deletion.md.hbs +10 -0
  44. package/assets/agents/alran/features/task-management.md.hbs +11 -0
  45. package/assets/agents/alran/features/web-search.md.hbs +11 -0
  46. package/assets/agents/alran/modes/coding/online/PERSONA.md.hbs +20 -0
  47. package/assets/agents/alran/modes/coding/online/SYSTEM.md.hbs +158 -0
  48. package/assets/agents/alran/modes/work/online/PERSONA.md.hbs +20 -0
  49. package/assets/agents/alran/modes/work/online/SYSTEM.md.hbs +160 -0
  50. package/assets/agents/alran/prompt-session-root.md +4 -0
  51. package/assets/agents/alran/prompt-session-root.md.hbs +4 -0
  52. package/assets/agents/alran/skills/alran-code-product/SKILL.md +72 -0
  53. package/assets/agents/alran/skills/alran-code-product/references/account-models.md +61 -0
  54. package/assets/agents/alran/skills/alran-code-product/references/agents.md +34 -0
  55. package/assets/agents/alran/skills/alran-code-product/references/extensions.md +46 -0
  56. package/assets/agents/alran/skills/alran-code-product/references/workflows.md +56 -0
  57. package/assets/agents/alran/skills/control-in-app-browser/SKILL.md +590 -0
  58. package/assets/agents/alran/system-prompt.md.hbs +97 -0
  59. package/assets/agents/builtin-agents.json +1 -0
  60. package/assets/agents/desktop-task/archive-title/system-en.md +1 -0
  61. package/assets/agents/desktop-task/checkpoint/system.md +19 -0
  62. package/assets/agents/desktop-task/output-revision/system.md +1 -0
  63. package/assets/agents/desktop-task/retry/continuation.md +4 -0
  64. package/assets/agents/desktop-task/session-title/system.md +41 -0
  65. package/assets/agents/explore/PERSONA.md +8 -0
  66. package/assets/agents/explore/agent.md +14 -0
  67. package/assets/agents/explore/system-prompt.md.hbs +35 -0
  68. package/assets/agents/greeting.md +61 -0
  69. package/assets/agents/managed-prompts.json +47 -0
  70. package/assets/agents/prompt-exemptions.json +36 -0
  71. package/assets/agents/verifier/PERSONA.md +8 -0
  72. package/assets/agents/verifier/agent.md +17 -0
  73. package/assets/agents/verifier/system-prompt.md.hbs +28 -0
  74. package/assets/agents/worker/PERSONA.md +8 -0
  75. package/assets/agents/worker/agent.md +18 -0
  76. package/assets/agents/worker/system-prompt.md.hbs +22 -0
  77. package/assets/agents/workflow/code-review/review-candidates.md +120 -0
  78. package/assets/agents/workflow/code-review/reviewer-system.md +75 -0
  79. package/assets/agents/workflow/goal/budget-limit.md +16 -0
  80. package/assets/agents/workflow/goal/continuation.md +62 -0
  81. package/assets/agents/workflow/goal/objective-updated.md +16 -0
  82. package/assets/agents/workflow/goal/recovery-terminal-audit.md +13 -0
  83. package/assets/agents/workflow/goal/recovery.md +11 -0
  84. package/assets/agents/workflow/goal/terminal-audit.md +10 -0
  85. package/assets/agents/workflow/plan-mode/agent-entry.md +72 -0
  86. package/assets/agents/workflow/prompt-hook/system.md +0 -0
  87. package/assets/models-dev-catalog.json.gz +0 -0
  88. package/assets/prompts/code-review/review-candidates.md +120 -0
  89. package/assets/prompts/code-review/reviewer-system.md +75 -0
  90. package/assets/skills/alran-tools-master/SKILL.md +127 -0
  91. package/assets/skills/code-review/SKILL.md +51 -0
  92. package/assets/skills/cu-desktop/SKILL.md +255 -0
  93. package/assets/skills/deep-research/SKILL.md +30 -0
  94. package/assets/skills/deploy-website/SKILL.md +52 -0
  95. package/assets/skills/docx/LICENSE +21 -0
  96. package/assets/skills/docx/SKILL.md +259 -0
  97. package/assets/skills/docx/assets/styles/academic_styles.xml +250 -0
  98. package/assets/skills/docx/assets/styles/corporate_styles.xml +284 -0
  99. package/assets/skills/docx/assets/styles/default_styles.xml +449 -0
  100. package/assets/skills/docx/assets/xsd/aesthetic-rules.xsd +470 -0
  101. package/assets/skills/docx/assets/xsd/business-rules.xsd +130 -0
  102. package/assets/skills/docx/assets/xsd/common-types.xsd +159 -0
  103. package/assets/skills/docx/assets/xsd/wml-subset.xsd +589 -0
  104. package/assets/skills/docx/docs/acceptance-checklists/create.md +7 -0
  105. package/assets/skills/docx/docs/acceptance-checklists/edit.md +6 -0
  106. package/assets/skills/docx/docs/acceptance-checklists/layout-repair.md +7 -0
  107. package/assets/skills/docx/docs/acceptance-checklists/template.md +6 -0
  108. package/assets/skills/docx/docs/acceptance.md +139 -0
  109. package/assets/skills/docx/docs/anti-patterns.md +14 -0
  110. package/assets/skills/docx/docs/backends.md +116 -0
  111. package/assets/skills/docx/docs/evidence.md +73 -0
  112. package/assets/skills/docx/docs/failure-taxonomy.md +71 -0
  113. package/assets/skills/docx/docs/index.md +50 -0
  114. package/assets/skills/docx/docs/rendered-delivery.md +125 -0
  115. package/assets/skills/docx/docs/router.md +122 -0
  116. package/assets/skills/docx/docs/tables-and-numbering.md +27 -0
  117. package/assets/skills/docx/docs/task-apply-template.md +141 -0
  118. package/assets/skills/docx/docs/task-compare-two-docx.md +48 -0
  119. package/assets/skills/docx/docs/task-create.md +124 -0
  120. package/assets/skills/docx/docs/task-edit-fill.md +69 -0
  121. package/assets/skills/docx/docs/task-read-content.md +148 -0
  122. package/assets/skills/docx/docs/task-read-rendered.md +78 -0
  123. package/assets/skills/docx/docs/task-read-structure.md +93 -0
  124. package/assets/skills/docx/docs/task-repair-layout.md +70 -0
  125. package/assets/skills/docx/docs/template-dsl.md +32 -0
  126. package/assets/skills/docx/docs/track-changes.md +15 -0
  127. package/assets/skills/docx/docs/xml-patch-dsl.md +33 -0
  128. package/assets/skills/docx/references/cjk_typography.md +357 -0
  129. package/assets/skills/docx/references/cjk_university_template_guide.md +184 -0
  130. package/assets/skills/docx/references/comments_guide.md +191 -0
  131. package/assets/skills/docx/references/design_good_bad_examples.md +829 -0
  132. package/assets/skills/docx/references/design_principles.md +819 -0
  133. package/assets/skills/docx/references/openxml_element_order.md +308 -0
  134. package/assets/skills/docx/references/openxml_encyclopedia_part1.md +4061 -0
  135. package/assets/skills/docx/references/openxml_encyclopedia_part2.md +2820 -0
  136. package/assets/skills/docx/references/openxml_encyclopedia_part3.md +3381 -0
  137. package/assets/skills/docx/references/openxml_namespaces.md +82 -0
  138. package/assets/skills/docx/references/openxml_units.md +72 -0
  139. package/assets/skills/docx/references/sample-patch-plans.json +22 -0
  140. package/assets/skills/docx/references/sample-task-intents.json +5 -0
  141. package/assets/skills/docx/references/sample-template-manifests.json +21 -0
  142. package/assets/skills/docx/references/scenario_a_create.md +284 -0
  143. package/assets/skills/docx/references/scenario_b_edit_content.md +295 -0
  144. package/assets/skills/docx/references/scenario_c_apply_template.md +456 -0
  145. package/assets/skills/docx/references/track_changes_guide.md +200 -0
  146. package/assets/skills/docx/references/troubleshooting.md +506 -0
  147. package/assets/skills/docx/references/typography_guide.md +294 -0
  148. package/assets/skills/docx/references/xsd_validation_guide.md +158 -0
  149. package/assets/skills/docx/scripts/build_patch_plan.py +29 -0
  150. package/assets/skills/docx/scripts/diff_docx_structure.py +61 -0
  151. package/assets/skills/docx/scripts/doc_to_docx.ps1 +85 -0
  152. package/assets/skills/docx/scripts/doc_to_docx.sh +40 -0
  153. package/assets/skills/docx/scripts/docx_preview.ps1 +76 -0
  154. package/assets/skills/docx/scripts/docx_preview.sh +37 -0
  155. package/assets/skills/docx/scripts/docx_to_pdf.py +87 -0
  156. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Cli/AlranAIDocx.Cli.csproj +19 -0
  157. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Cli/Program.cs +18 -0
  158. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/AlranAIDocx.Core.csproj +15 -0
  159. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/AnalyzeCommand.cs +147 -0
  160. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/ApplyTemplateCommand.cs +322 -0
  161. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/CreateCommand.cs +324 -0
  162. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/DiffCommand.cs +155 -0
  163. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/EditContentCommand.cs +487 -0
  164. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/FixOrderCommand.cs +108 -0
  165. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/MergeRunsCommand.cs +122 -0
  166. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/ValidateCommand.cs +107 -0
  167. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/CommentSynchronizer.cs +169 -0
  168. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/ElementOrder.cs +80 -0
  169. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/NamespaceConstants.cs +42 -0
  170. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/RunMerger.cs +81 -0
  171. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/StyleAnalyzer.cs +81 -0
  172. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/TrackChangesHelper.cs +99 -0
  173. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/UnitConverter.cs +23 -0
  174. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples.cs +1832 -0
  175. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch1.cs +910 -0
  176. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch2.cs +999 -0
  177. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch3.cs +1048 -0
  178. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch4.cs +1038 -0
  179. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/CharacterFormattingSamples.cs +1020 -0
  180. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/DocumentCreationSamples.cs +1121 -0
  181. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/FieldAndTocSamples.cs +624 -0
  182. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/FootnoteAndCommentSamples.cs +675 -0
  183. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/HeaderFooterSamples.cs +838 -0
  184. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/ImageSamples.cs +917 -0
  185. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/ListAndNumberingSamples.cs +826 -0
  186. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/ParagraphFormattingSamples.cs +1199 -0
  187. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/StyleSystemSamples.cs +1487 -0
  188. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/TableSamples.cs +1163 -0
  189. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/TrackChangesSamples.cs +595 -0
  190. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Typography/CjkHelper.cs +39 -0
  191. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Typography/FontDefaults.cs +24 -0
  192. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Typography/PageSizes.cs +20 -0
  193. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/BusinessRuleValidator.cs +224 -0
  194. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/GateCheckValidator.cs +148 -0
  195. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/ValidationResult.cs +23 -0
  196. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/XsdValidator.cs +69 -0
  197. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.slnx +4 -0
  198. package/assets/skills/docx/scripts/env_check.ps1 +327 -0
  199. package/assets/skills/docx/scripts/env_check.sh +340 -0
  200. package/assets/skills/docx/scripts/extract_docx_text.py +1075 -0
  201. package/assets/skills/docx/scripts/pack_docx.py +31 -0
  202. package/assets/skills/docx/scripts/read_docx_structure.py +1032 -0
  203. package/assets/skills/docx/scripts/render_docx_pages.py +147 -0
  204. package/assets/skills/docx/scripts/rendered_report.py +609 -0
  205. package/assets/skills/docx/scripts/setup.ps1 +542 -0
  206. package/assets/skills/docx/scripts/setup.sh +537 -0
  207. package/assets/skills/docx/scripts/unpack_docx.py +29 -0
  208. package/assets/skills/docx/scripts/validate_template_manifest.py +60 -0
  209. package/assets/skills/docx/scripts/verify_anchor_atomicity.py +87 -0
  210. package/assets/skills/edit-deployed-website/SKILL.md +27 -0
  211. package/assets/skills/init/SKILL.md +135 -0
  212. package/assets/skills/llm-call/SKILL.md +48 -0
  213. package/assets/skills/llm-call/scripts/llm_call.py +458 -0
  214. package/assets/skills/pdf/SKILL.md +280 -0
  215. package/assets/skills/pdf/docs/advanced-reference.md +711 -0
  216. package/assets/skills/pdf/docs/create-guide.md +437 -0
  217. package/assets/skills/pdf/docs/design-guide.md +204 -0
  218. package/assets/skills/pdf/docs/forms-guide.md +462 -0
  219. package/assets/skills/pdf/docs/html-pdf-spec.md +500 -0
  220. package/assets/skills/pdf/docs/latex-academic-thesis-guide.md +233 -0
  221. package/assets/skills/pdf/docs/latex-technical-book-guide.md +112 -0
  222. package/assets/skills/pdf/docs/pitfalls-index.md +792 -0
  223. package/assets/skills/pdf/docs/read-guide.md +358 -0
  224. package/assets/skills/pdf/docs/reformat-guide.md +238 -0
  225. package/assets/skills/pdf/docs/skill-readme-archive.md +151 -0
  226. package/assets/skills/pdf/docs/troubleshooting.md +86 -0
  227. package/assets/skills/pdf/docs/vision-guide.md +188 -0
  228. package/assets/skills/pdf/scripts/__init__.py +0 -0
  229. package/assets/skills/pdf/scripts/_pdf_read_lib.py +284 -0
  230. package/assets/skills/pdf/scripts/fill/__init__.py +0 -0
  231. package/assets/skills/pdf/scripts/fill/acroform_apply.py +153 -0
  232. package/assets/skills/pdf/scripts/fill/overlay_apply.py +109 -0
  233. package/assets/skills/pdf/scripts/lib/__init__.py +0 -0
  234. package/assets/skills/pdf/scripts/lib/acroform_io.py +170 -0
  235. package/assets/skills/pdf/scripts/lib/cli_utils.py +41 -0
  236. package/assets/skills/pdf/scripts/lib/geometry.py +79 -0
  237. package/assets/skills/pdf/scripts/make.sh +388 -0
  238. package/assets/skills/pdf/scripts/merge.py +112 -0
  239. package/assets/skills/pdf/scripts/pdf_inspect/__init__.py +0 -0
  240. package/assets/skills/pdf/scripts/pdf_inspect/acroform_inspect.py +52 -0
  241. package/assets/skills/pdf/scripts/pdf_inspect/acroform_probe.py +57 -0
  242. package/assets/skills/pdf/scripts/pdf_inspect/layout_scan.py +164 -0
  243. package/assets/skills/pdf/scripts/read_pdf_vision.py +473 -0
  244. package/assets/skills/pdf/scripts/reformat_parse.py +181 -0
  245. package/assets/skills/pdf/scripts/render/__init__.py +0 -0
  246. package/assets/skills/pdf/scripts/render/overlay_preview.py +86 -0
  247. package/assets/skills/pdf/scripts/render/page_rasterize.py +85 -0
  248. package/assets/skills/pdf/scripts/render_html.cjs +205 -0
  249. package/assets/skills/pdf/scripts/validate/__init__.py +0 -0
  250. package/assets/skills/pdf/scripts/validate/geometry_lint.py +124 -0
  251. package/assets/skills/pdf/templates/INDEX.md +90 -0
  252. package/assets/skills/pdf/templates/bilingual-menu-premium/README.md +175 -0
  253. package/assets/skills/pdf/templates/bilingual-menu-premium/skeleton.html +343 -0
  254. package/assets/skills/pdf/templates/brand-guide-2page/README.md +140 -0
  255. package/assets/skills/pdf/templates/brand-guide-2page/skeleton.html +264 -0
  256. package/assets/skills/pdf/templates/data-viz-report/README.md +234 -0
  257. package/assets/skills/pdf/templates/data-viz-report/skeleton.html +835 -0
  258. package/assets/skills/pdf/templates/form-fill-acroform/README.md +195 -0
  259. package/assets/skills/pdf/templates/form-fill-acroform/field_values.template.json +118 -0
  260. package/assets/skills/pdf/templates/latex-academic-thesis/README.md +146 -0
  261. package/assets/skills/pdf/templates/latex-academic-thesis/source.tex +334 -0
  262. package/assets/skills/pdf/templates/latex-technical-book/README.md +130 -0
  263. package/assets/skills/pdf/templates/latex-technical-book/README.template-source.md +62 -0
  264. package/assets/skills/pdf/templates/latex-technical-book/source.tex +439 -0
  265. package/assets/skills/pdf/templates/multi-article-aggregator/README.md +148 -0
  266. package/assets/skills/pdf/templates/multi-article-aggregator/pipeline.md +223 -0
  267. package/assets/skills/pdf/templates/multilang-research-report/README.md +136 -0
  268. package/assets/skills/pdf/templates/multilang-research-report/skeleton.html +242 -0
  269. package/assets/skills/pdf/templates/reformat-default/README.md +136 -0
  270. package/assets/skills/pdf/templates/reformat-default/skeleton.html +204 -0
  271. package/assets/skills/pdf/templates/translate-preserve-layout/README.md +136 -0
  272. package/assets/skills/pdf/templates/translate-preserve-layout/skeleton.html +96 -0
  273. package/assets/skills/pdf/templates/translate-preserve-layout/terminology.template.json +66 -0
  274. package/assets/skills/pptx/SKILL.md +283 -0
  275. package/assets/skills/pptx/references/design-system.md +424 -0
  276. package/assets/skills/pptx/references/editing.md +162 -0
  277. package/assets/skills/pptx/references/element-map.md +229 -0
  278. package/assets/skills/pptx/references/pitfalls.md +205 -0
  279. package/assets/skills/pptx/references/pptxgenjs.md +420 -0
  280. package/assets/skills/pptx/references/preview-selection-writeback.md +65 -0
  281. package/assets/skills/pptx/references/python-pptx-recipes.md +63 -0
  282. package/assets/skills/pptx/references/slide-types.md +413 -0
  283. package/assets/skills/pptx/scripts/alran-ppt-map.cjs +280 -0
  284. package/assets/skills/pptx/scripts/audit_pptx.py +708 -0
  285. package/assets/skills/pptx/scripts/extract_comments.py +468 -0
  286. package/assets/skills/pptx/scripts/extract_images.py +226 -0
  287. package/assets/skills/pptx/scripts/extract_pptx.py +285 -0
  288. package/assets/skills/pptx/scripts/pdf2png.swift +203 -0
  289. package/assets/skills/pptx/scripts/pptx-screenshot.sh +105 -0
  290. package/assets/skills/resume-codex/SKILL.md +53 -0
  291. package/assets/skills/resume-codex/scripts/session-reader.mjs +445 -0
  292. package/assets/skills/skill-creator/SKILL.md +188 -0
  293. package/assets/skills/skill-creator/references/anti-patterns.md +149 -0
  294. package/assets/skills/skill-creator/references/commands-macos-linux.md +38 -0
  295. package/assets/skills/skill-creator/references/commands-windows-powershell.md +48 -0
  296. package/assets/skills/skill-creator/references/description-rubric.md +83 -0
  297. package/assets/skills/skill-creator/references/skill-template.md +101 -0
  298. package/assets/skills/skill-creator/references/when-to-bundle-scripts.md +139 -0
  299. package/assets/skills/skill-creator/scripts/lint-skill.js +226 -0
  300. package/assets/skills/skill-refiner/SKILL.md +137 -0
  301. package/assets/skills/visual-page/SKILL.md +194 -0
  302. package/assets/skills/x-link-reader/SKILL.md +108 -0
  303. package/assets/skills/xlsx/SKILL.md +498 -0
  304. package/assets/skills/xlsx/docs/advanced-reference.md +410 -0
  305. package/assets/skills/xlsx/docs/conventions-guide.md +217 -0
  306. package/assets/skills/xlsx/docs/create-edit-guide.md +410 -0
  307. package/assets/skills/xlsx/docs/pitfalls-index.md +759 -0
  308. package/assets/skills/xlsx/docs/raw-xml-escape-hatch.md +201 -0
  309. package/assets/skills/xlsx/docs/recalc-guide.md +295 -0
  310. package/assets/skills/xlsx/scripts/office/helpers/__init__.py +0 -0
  311. package/assets/skills/xlsx/scripts/office/helpers/merge_runs.py +199 -0
  312. package/assets/skills/xlsx/scripts/office/helpers/simplify_redlines.py +197 -0
  313. package/assets/skills/xlsx/scripts/office/pack.py +159 -0
  314. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-chart.xsd +1499 -0
  315. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-chartDrawing.xsd +146 -0
  316. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-diagram.xsd +1085 -0
  317. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-lockedCanvas.xsd +11 -0
  318. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-main.xsd +3081 -0
  319. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-picture.xsd +23 -0
  320. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-spreadsheetDrawing.xsd +185 -0
  321. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-wordprocessingDrawing.xsd +287 -0
  322. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/pml.xsd +1676 -0
  323. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-additionalCharacteristics.xsd +28 -0
  324. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-bibliography.xsd +144 -0
  325. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-commonSimpleTypes.xsd +174 -0
  326. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-customXmlDataProperties.xsd +25 -0
  327. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-customXmlSchemaProperties.xsd +18 -0
  328. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesCustom.xsd +59 -0
  329. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesExtended.xsd +56 -0
  330. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesVariantTypes.xsd +195 -0
  331. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-math.xsd +582 -0
  332. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-relationshipReference.xsd +25 -0
  333. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/sml.xsd +4439 -0
  334. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-main.xsd +570 -0
  335. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-officeDrawing.xsd +509 -0
  336. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-presentationDrawing.xsd +12 -0
  337. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-spreadsheetDrawing.xsd +108 -0
  338. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-wordprocessingDrawing.xsd +96 -0
  339. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/wml.xsd +3646 -0
  340. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/xml.xsd +116 -0
  341. package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-contentTypes.xsd +42 -0
  342. package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-coreProperties.xsd +50 -0
  343. package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-digSig.xsd +49 -0
  344. package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-relationships.xsd +33 -0
  345. package/assets/skills/xlsx/scripts/office/schemas/mce/mc.xsd +75 -0
  346. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-2010.xsd +560 -0
  347. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-2012.xsd +67 -0
  348. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-2018.xsd +14 -0
  349. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-cex-2018.xsd +20 -0
  350. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-cid-2016.xsd +13 -0
  351. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-sdtdatahash-2020.xsd +4 -0
  352. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-symex-2015.xsd +8 -0
  353. package/assets/skills/xlsx/scripts/office/soffice.py +191 -0
  354. package/assets/skills/xlsx/scripts/office/unpack.py +132 -0
  355. package/assets/skills/xlsx/scripts/office/validate.py +117 -0
  356. package/assets/skills/xlsx/scripts/office/validators/__init__.py +15 -0
  357. package/assets/skills/xlsx/scripts/office/validators/base.py +851 -0
  358. package/assets/skills/xlsx/scripts/office/validators/docx.py +446 -0
  359. package/assets/skills/xlsx/scripts/office/validators/pptx.py +275 -0
  360. package/assets/skills/xlsx/scripts/office/validators/redlining.py +247 -0
  361. package/assets/skills/xlsx/scripts/recalc.py +450 -0
  362. package/chunks/account-commands-JZ6NXTTK.js +2 -0
  363. package/chunks/anthropic-MN33DP4E.js +2 -0
  364. package/chunks/application-ITGAJ4HC.js +2 -0
  365. package/chunks/auth-command-V3RVPLZO.js +2 -0
  366. package/chunks/azure-openai-responses-OWHMUNKC.js +2 -0
  367. package/chunks/chunk-2TF6JAQM.js +2 -0
  368. package/chunks/chunk-33CNY6GP.js +2 -0
  369. package/chunks/chunk-3AODGLMF.js +2 -0
  370. package/chunks/chunk-44VPC5LA.js +38 -0
  371. package/chunks/chunk-4CN3IJFH.js +2 -0
  372. package/chunks/chunk-4PDIO3M6.js +2 -0
  373. package/chunks/chunk-4X22UJQH.js +164 -0
  374. package/chunks/chunk-6255CZPL.js +2 -0
  375. package/chunks/chunk-6P4UKHGR.js +2 -0
  376. package/chunks/chunk-7QLAXRD2.js +1085 -0
  377. package/chunks/chunk-7XYOYZX2.js +2 -0
  378. package/chunks/chunk-A7GMJNA2.js +29 -0
  379. package/chunks/chunk-AGUSPIUP.js +2 -0
  380. package/chunks/chunk-BQ3CF3KE.js +2 -0
  381. package/chunks/chunk-C3CMJAAV.js +3 -0
  382. package/chunks/chunk-CJM7ZJ6W.js +7 -0
  383. package/chunks/chunk-CSOUJVKM.js +2 -0
  384. package/chunks/chunk-D66ZSHXR.js +2 -0
  385. package/chunks/chunk-D7MGU75P.js +2 -0
  386. package/chunks/chunk-E3GLGDGC.js +5 -0
  387. package/chunks/chunk-ENHOPPS7.js +16 -0
  388. package/chunks/chunk-EOR6EDNR.js +2 -0
  389. package/chunks/chunk-EYK25HWR.js +2 -0
  390. package/chunks/chunk-F46IELF5.js +2 -0
  391. package/chunks/chunk-FC4M2B7E.js +2 -0
  392. package/chunks/chunk-FSNYOJPJ.js +2 -0
  393. package/chunks/chunk-FUERW2DW.js +3 -0
  394. package/chunks/chunk-FXOH6TEQ.js +21 -0
  395. package/chunks/chunk-GP52JZMY.js +2 -0
  396. package/chunks/chunk-GRXX6I72.js +2 -0
  397. package/chunks/chunk-GSYHBK5Q.js +6 -0
  398. package/chunks/chunk-HNWBFJNO.js +2 -0
  399. package/chunks/chunk-IIE366LR.js +6706 -0
  400. package/chunks/chunk-IWK7PZP7.js +207 -0
  401. package/chunks/chunk-J3KCPYZT.js +2 -0
  402. package/chunks/chunk-KCLRJQ53.js +59 -0
  403. package/chunks/chunk-LU4RPLJ3.js +2 -0
  404. package/chunks/chunk-LZJYNT32.js +2 -0
  405. package/chunks/chunk-M7GW4VMR.js +27 -0
  406. package/chunks/chunk-MACBL5HF.js +2 -0
  407. package/chunks/chunk-N5NTXCJI.js +2 -0
  408. package/chunks/chunk-N5SVBCUB.js +7 -0
  409. package/chunks/chunk-N6W7ZL26.js +2 -0
  410. package/chunks/chunk-NWB7LFOK.js +131 -0
  411. package/chunks/chunk-OIQ336YE.js +16 -0
  412. package/chunks/chunk-OQNU3VPS.js +30 -0
  413. package/chunks/chunk-OTDNOWXG.js +16 -0
  414. package/chunks/chunk-PNXZWSWT.js +3 -0
  415. package/chunks/chunk-QFUV5PX6.js +2 -0
  416. package/chunks/chunk-QIN5ZBE2.js +2 -0
  417. package/chunks/chunk-QKBN5CGI.js +2 -0
  418. package/chunks/chunk-QPGTKSIQ.js +2 -0
  419. package/chunks/chunk-SIOLUFGG.js +2 -0
  420. package/chunks/chunk-TW23QKAD.js +3 -0
  421. package/chunks/chunk-U3RMPDXU.js +2 -0
  422. package/chunks/chunk-U7U3DJHF.js +2 -0
  423. package/chunks/chunk-VLXX22YO.js +2 -0
  424. package/chunks/chunk-WHD2XVT2.js +2 -0
  425. package/chunks/chunk-WTAJMYF2.js +249 -0
  426. package/chunks/chunk-WWNUAU4P.js +29 -0
  427. package/chunks/chunk-WYANV3IX.js +4 -0
  428. package/chunks/chunk-XAGZ6ZEU.js +9 -0
  429. package/chunks/chunk-XFCC2CI2.js +24 -0
  430. package/chunks/chunk-XQK7JM66.js +2 -0
  431. package/chunks/chunk-YLQXZBEL.js +2 -0
  432. package/chunks/chunk-YPV2X2RG.js +2 -0
  433. package/chunks/chunk-Z6BHCXKT.js +25 -0
  434. package/chunks/chunk-Z6HBNJCA.js +8 -0
  435. package/chunks/chunk-ZQKVUPKA.js +2 -0
  436. package/chunks/chunk-ZQOALVGL.js +2 -0
  437. package/chunks/clipboard-image-PQPC4EHR.js +2 -0
  438. package/chunks/data-dir-LDVKDCJ2.js +2 -0
  439. package/chunks/dist-2BRD4JFU.js +11 -0
  440. package/chunks/dist-EXKHRFQO.js +5 -0
  441. package/chunks/emscripten-module-RD6P2XH5.js +2 -0
  442. package/chunks/emscripten-module-WYNDFH3N.js +2 -0
  443. package/chunks/emscripten-module-XPTEOIWW.js +2 -0
  444. package/chunks/emscripten-module-ZS3PMSDF.js +2 -0
  445. package/chunks/ffi-IO7WZQNG.js +2 -0
  446. package/chunks/ffi-M5UP5J6C.js +2 -0
  447. package/chunks/ffi-ORLOPBB3.js +2 -0
  448. package/chunks/ffi-OUPK6AY6.js +2 -0
  449. package/chunks/google-UJAPMFAB.js +2 -0
  450. package/chunks/google-vertex-VLSF55PW.js +2 -0
  451. package/chunks/install-source-JTIUC4G4.js +2 -0
  452. package/chunks/launcher-FCZ3EDBF.js +61 -0
  453. package/chunks/lifecycle-GY435YMF.js +2 -0
  454. package/chunks/main-TQGGRHTS.js +13 -0
  455. package/chunks/mistral-ZJZUEF2X.js +3 -0
  456. package/chunks/module-6F3E5H7Y-BN7QWGYB.js +2 -0
  457. package/chunks/module-asyncify-R6PWJ6ZV-P4FWSBAY.js +2 -0
  458. package/chunks/multipart-parser-L6M455MS.js +2 -0
  459. package/chunks/network-proxy-U72JCK2I.js +2 -0
  460. package/chunks/openai-codex-responses-FPCDNRL5.js +2 -0
  461. package/chunks/openai-completions-D32YW6KL.js +2 -0
  462. package/chunks/openai-responses-ZCGSENM4.js +2 -0
  463. package/chunks/openrouter-G2EHY5BD.js +2 -0
  464. package/chunks/otel-OHXIZ666.js +2 -0
  465. package/chunks/package-contract-GVXTMJ3N.js +2 -0
  466. package/chunks/pdfjs-SHZAF7PF.js +107 -0
  467. package/chunks/photon_rs-C52RL4CI.js +3 -0
  468. package/chunks/plugin-command-OSAFHS7C.js +2 -0
  469. package/chunks/provider-command-SKTCHD4E.js +2 -0
  470. package/chunks/questionnaire-bridge-ISQOCYWY.js +2 -0
  471. package/chunks/run-acp-command-SG2BDMFJ.js +2 -0
  472. package/chunks/run-exec-command-5ADSQR2Z.js +15 -0
  473. package/chunks/skills-command-XXXEZAG6.js +2 -0
  474. package/chunks/src-DNIDEMVV.js +2 -0
  475. package/chunks/src-IBHIRTD7.js +2 -0
  476. package/chunks/telemetry-J7ZLGF5X.js +2 -0
  477. package/chunks/telemetry-command-COQG2AKK.js +5 -0
  478. package/chunks/tools-WDBB2JKV.js +2 -0
  479. package/chunks/undici-TUGHZJSA.js +2 -0
  480. package/chunks/update-NB6OD572.js +14 -0
  481. package/chunks/update-hint-ED7O67WU.js +3 -0
  482. package/chunks/wechat-onboard-UWXQW2HT.js +2 -0
  483. package/cli.js +5 -0
  484. package/configs/data-minimal.yaml +50 -0
  485. package/embedded/alran-tools/cli.mjs +4961 -0
  486. package/embedded/alran-tools/manifest.json +25 -0
  487. package/emscripten-module.wasm +0 -0
  488. package/image-preview-worker.js +2 -0
  489. package/internal-bin/alran-tools +9 -0
  490. package/internal-bin/alran-tools.cmd +8 -0
  491. package/matrix-mcp-stdio.js +4 -0
  492. package/native/darwin/prebuilds/darwin-arm64/darwin-modifiers.node +0 -0
  493. package/native/darwin/prebuilds/darwin-x64/darwin-modifiers.node +0 -0
  494. package/native/win32/prebuilds/win32-arm64/win32-console-mode.node +0 -0
  495. package/native/win32/prebuilds/win32-x64/win32-console-mode.node +0 -0
  496. package/package.json +38 -4
  497. package/photon_rs_bg.wasm +0 -0
  498. package/quickjs-worker.js +152 -0
  499. package/vendor/java-proxy-agent/build.ts +97 -0
  500. package/vendor/java-proxy-agent/srt-proxy-agent.jar +0 -0
  501. package/vendor/seccomp/arm64/apply-seccomp +0 -0
  502. package/vendor/seccomp/build.ts +74 -0
  503. package/vendor/seccomp/x64/apply-seccomp +0 -0
  504. package/vendor/srt-win/arm64/srt-win.exe +0 -0
  505. package/vendor/srt-win/build.ts +40 -0
  506. package/vendor/srt-win/x64/srt-win.exe +0 -0
@@ -0,0 +1,259 @@
1
+ ---
2
+ name: docx
3
+ metadata:
4
+ version: "4.0.0"
5
+ category: document-processing
6
+ status: stable
7
+ author: AlranAI
8
+ sources:
9
+ - "ECMA-376 Office Open XML File Formats"
10
+ - "GB/T 9704-2012 Layout Standard for Official Documents"
11
+ - "IEEE / ACM / APA / MLA / Chicago / Turabian Style Guides"
12
+ - "Springer LNCS / Nature / HBR Document Templates"
13
+ description: >
14
+ Unified DOCX skill — create, template-apply, edit/fill, read, repair, and compare Word documents.
15
+ Use for formal Word deliverables and DOCX diagnosis. Not for PDF/PPT or casual plain-text drafting.
16
+ triggers:
17
+ - Word
18
+ - docx
19
+ - document
20
+ - 文档
21
+ - Word文档
22
+ - 报告
23
+ - 合同
24
+ - 公文
25
+ - 套模板
26
+ - 排版
27
+ - 修目录
28
+ - 修页眉页脚
29
+ ---
30
+
31
+ # docx
32
+
33
+ Replace `<skill_dir>` with the actual skill path shown by the loader.
34
+
35
+ Unified DOCX skill. `SKILL.md` is the dispatch layer. Pick the route that matches the user’s intent,
36
+ read that route guide, then go straight into execution. Do not front-load every task with the full
37
+ evidence/backend/acceptance waterfall.
38
+
39
+ ## Environment gates
40
+
41
+ The env gate ships in two equivalent dialects so the skill works on macOS, Linux/WSL, and
42
+ Windows without any cygwin/git-bash hack:
43
+
44
+ | Platform | Setup | Env check |
45
+ |---|---|---|
46
+ | macOS / Linux / WSL | `bash <skill_dir>/scripts/setup.sh` | `bash <skill_dir>/scripts/env_check.sh --level <lvl>` |
47
+ | Windows (PowerShell 5.1+) | `powershell -ExecutionPolicy Bypass -File <skill_dir>\scripts\setup.ps1` | `powershell -ExecutionPolicy Bypass -File <skill_dir>\scripts\env_check.ps1 -Level <lvl>` |
48
+
49
+ Both dialects accept the same three levels (`read | render | full`, default `full`) and produce
50
+ the same `[OK] / [FAIL] / Status: READY|NOT READY` lines, so a route may be gated on either one.
51
+
52
+ The skill loader runs **only the read gate** at load time, so missing dotnet/soffice does not
53
+ block read-only routes.
54
+
55
+ ### Read gate
56
+
57
+ Checked at skill load time (automatic). Applies to: `READ_CONTENT`, `READ_STRUCTURE`, `COMPARE_TWO_DOCX`.
58
+
59
+ ```bash
60
+ # macOS / Linux / WSL
61
+ bash <skill_dir>/scripts/env_check.sh --level read
62
+
63
+ # Windows
64
+ powershell -ExecutionPolicy Bypass -File <skill_dir>\scripts\env_check.ps1 -Level Read
65
+ ```
66
+
67
+ Requires: `python3` (or `python` launcher on Windows), `unzip` (or `tar.exe` on Windows 10+), UTF-8 console.
68
+
69
+ If the read gate fails, the skill cannot load at all.
70
+
71
+ ### Render gate
72
+
73
+ Run before `READ_RENDERED` routes. Includes all read-level checks plus:
74
+
75
+ ```bash
76
+ bash <skill_dir>/scripts/env_check.sh --level render # *nix
77
+ powershell -ExecutionPolicy Bypass -File <skill_dir>\scripts\env_check.ps1 -Level Render # Windows
78
+ ```
79
+
80
+ Requires (in addition to read): `soffice` / `soffice.exe`, `pdftoppm` (or `pdftocairo`).
81
+
82
+ If the render gate fails, stop and report. Do not silently fall back to structure-only reads.
83
+
84
+ ### Full gate
85
+
86
+ Run before `CREATE_DOCX`, `APPLY_TEMPLATE`, `EDIT_FILL_DOCX`, `REPAIR_LAYOUT` routes.
87
+
88
+ ```bash
89
+ bash <skill_dir>/scripts/env_check.sh --level full # *nix
90
+ powershell -ExecutionPolicy Bypass -File <skill_dir>\scripts\env_check.ps1 -Level Full # Windows
91
+ ```
92
+
93
+ Requires (in addition to render): `dotnet` >= 9, `pandoc`, `zip` (or `Compress-Archive` on Windows),
94
+ dotnet project built.
95
+
96
+ If the full gate fails, stop and report. Do not attempt generation with missing dependencies.
97
+
98
+ ### Cross-platform path & temp-dir convention
99
+
100
+ Examples in `docs/` and `references/` are written for *nix shells. When you execute on Windows,
101
+ do these substitutions consistently:
102
+
103
+ | In the example | Windows substitute |
104
+ |---|---|
105
+ | `<skill_dir>/scripts/foo.sh` | `<skill_dir>\scripts\foo.ps1` (every `.sh` has a `.ps1` peer) |
106
+ | `python3 <skill_dir>/scripts/foo.py` | `python <skill_dir>\scripts\foo.py` (the `.py` files are cross-platform) |
107
+ | `/tmp/docx-<thing>` | `$env:TEMP\docx-<thing>` |
108
+ | `bash <skill_dir>/scripts/setup.sh` | `powershell -ExecutionPolicy Bypass -File <skill_dir>\scripts\setup.ps1` |
109
+ | `forward slashes in paths` | backslashes; quote any path containing spaces |
110
+
111
+ Never invoke a `.sh` script through git-bash on Windows — `setup.sh` will refuse to install
112
+ anything on `MINGW*/MSYS*/CYGWIN*` and tell you to switch to `powershell.exe` / `pwsh.exe`.
113
+
114
+ ## Operational rules — read before doing anything
115
+
116
+ > **1. Dispatch by user intent, not by backend.**
117
+ >
118
+ > Start with the shortest route choice:
119
+ >
120
+ > - creating a new formal Word deliverable -> `CREATE_DOCX`
121
+ > - preserving content but changing template / institutional style -> `APPLY_TEMPLATE`
122
+ > - editing an existing DOCX in place -> `EDIT_FILL_DOCX`
123
+ > - reading text / structure / rendered pages -> matching read route
124
+ > - fixing visible defects -> `REPAIR_LAYOUT`
125
+ > - comparing two DOCX files -> `COMPARE_TWO_DOCX`
126
+ >
127
+ > Read `docs/router.md` only to settle the route. Do not read `docs/evidence.md`, `docs/backends.md`,
128
+ > and `docs/acceptance.md` before route selection.
129
+
130
+ > **2. For generation routes, choose style family / recipe before backend.**
131
+ >
132
+ > The old benchmarked generation core stays in this skill. For `CREATE_DOCX` and `APPLY_TEMPLATE`,
133
+ > the first substantive decision is the visual system, not the backend. Reuse these files as the
134
+ > generation core:
135
+ >
136
+ > - `references/typography_guide.md`
137
+ > - `references/design_principles.md`
138
+ > - `references/cjk_typography.md`
139
+ > - `scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples*.cs`
140
+ >
141
+ > These are not optional decoration. They are the quality-preserving recipe layer.
142
+
143
+ > **3. Backend comes after route + recipe.**
144
+ >
145
+ > - `D` is the default write backend for formal DOCX creation, template application, and most edits.
146
+ > - `S` is only for OpenXML graph work beyond the builtin CLI surface.
147
+ > - `X` is only for deterministic local XML patch / inspection work.
148
+ > - Formal `CREATE_DOCX` is never routed to pandoc as a generation backend.
149
+ > - If a chosen backend gate fails, stop and report it. Do not silently switch.
150
+
151
+ > **4. Rendered acceptance is a post-write gate, not a pre-dispatch hop.**
152
+ >
153
+ > For template, layout, TOC, multi-section, header/footer, and page-number work, finish the write
154
+ > first, then run rendered acceptance from `docs/acceptance.md` / `docs/rendered-delivery.md`.
155
+
156
+ > **5. Keep DOCX execution inside this skill.**
157
+ >
158
+ > Do not bounce rendered diagnosis to another skill. Do not treat raw XML string replace as a valid
159
+ > editing strategy. Do not use `readlink`, `$0`, or shell path tricks in skill docs; use `<skill_dir>` only.
160
+
161
+ > **6. DOCX→PDF is native to this skill.**
162
+ > If the user asks to convert an existing Word/DOCX document to PDF while
163
+ > preserving layout, do it here via `python3 <skill_dir>/scripts/docx_to_pdf.py`
164
+ > (or `soffice --headless --convert-to pdf` as fallback), then verify the PDF.
165
+ > Do not route DOCX→Markdown/HTML→PDF for a preservation task: DOCX already
166
+ > carries page geometry, sections, headers/footers, fields, numbering, and table
167
+ > layout. HTML/PDF belongs to redesign/recomposition after native render fails
168
+ > or when explicitly requested.
169
+
170
+ ## Routes — pick one, then read that guide
171
+
172
+ ### WRITE / GENERATE a DOCX
173
+
174
+ | Intent | Guide | What happens next |
175
+ |---|---|---|
176
+ | **CREATE_DOCX** — author a new report / proposal / contract / memo / thesis / 公文 | `docs/task-create.md` | normalize source -> choose recipe family -> choose `D`/`S` -> write -> acceptance |
177
+ | **APPLY_TEMPLATE** — preserve content but move into a template / institutional visual system | `docs/task-apply-template.md` | choose template mode -> align recipe family -> read only the needed structure -> choose `D`/`S` -> write -> strict rendered acceptance |
178
+ | **EDIT_FILL_DOCX** — mutate content in an existing DOCX while keeping it the same document | `docs/task-edit-fill.md` | choose edit mode -> choose `X`/`D`/`S` -> mutate -> acceptance |
179
+
180
+ ### READ / DIAGNOSE / REPAIR a DOCX
181
+
182
+ | Intent | Guide | Primary truth |
183
+ |---|---|---|
184
+ | **READ_CONTENT** — summarize / quote / retrieve text | `docs/task-read-content.md` | content |
185
+ | **READ_STRUCTURE** — inspect styles / sections / numbering / TOC / comments / revisions | `docs/task-read-structure.md` | structure |
186
+ | **READ_RENDERED** — inspect what the pages actually look like | `docs/task-read-rendered.md` | rendered + structure |
187
+ | **REPAIR_LAYOUT** — fix page-level defects | `docs/task-repair-layout.md` | rendered -> structure -> rendered |
188
+ | **COMPARE_TWO_DOCX** — explain before/after or source/template differences | `docs/task-compare-two-docx.md` | content + structure + rendered |
189
+
190
+ ## Deep docs — only after the route is clear
191
+
192
+ | File | Use when |
193
+ |---|---|
194
+ | `docs/router.md` | settle route choice |
195
+ | `docs/evidence.md` | the selected route needs truth-source clarification |
196
+ | `docs/backends.md` | the selected route needs backend arbitration |
197
+ | `docs/acceptance.md` | you are ready to validate deliverables |
198
+ | `docs/rendered-delivery.md` | rendered issue report shape is required |
199
+
200
+ ## Generation core references
201
+
202
+ Use these after `CREATE_DOCX` / `APPLY_TEMPLATE` is selected:
203
+
204
+ | File | Role |
205
+ |---|---|
206
+ | `references/scenario_a_create.md` | create-from-scratch mechanics |
207
+ | `references/scenario_c_apply_template.md` | template transfer and multi-section rules |
208
+ | `references/typography_guide.md` | font pairings, sizes, spacing, page layout, table rules |
209
+ | `references/design_principles.md` | visual judgment rules when exact specs are missing |
210
+ | `references/cjk_typography.md` | CJK fonts, 字号, mixed-script rules, 公文 defaults |
211
+ | `scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples*.cs` | benchmarked recipe families; choose one instead of inventing values |
212
+
213
+ ## Runtime shorthands
214
+
215
+ ```bash
216
+ # macOS / Linux / WSL
217
+ CLI="dotnet run --project <skill_dir>/scripts/dotnet/AlranAIDocx.Cli --"
218
+ TMPDIR_DOCX="${TMPDIR:-/tmp}"
219
+ ```
220
+
221
+ ```powershell
222
+ # Windows PowerShell
223
+ $CLI = "dotnet run --project <skill_dir>\scripts\dotnet\AlranAIDocx.Cli --"
224
+ $TmpDocx = $env:TEMP
225
+ ```
226
+
227
+ Common commands (substitute `$TMPDIR_DOCX` / `$TmpDocx` for the literal `/tmp` examples elsewhere
228
+ in `docs/`):
229
+
230
+ ```bash
231
+ $CLI analyze --input in.docx --json
232
+ $CLI diff --before before.docx --after after.docx
233
+ $CLI merge-runs --input out.docx
234
+ $CLI validate --input out.docx --xsd <skill_dir>/assets/xsd/wml-subset.xsd
235
+ $CLI validate --input out.docx --business
236
+ $CLI validate --input out.docx --gate-check <skill_dir>/assets/xsd/business-rules.xsd
237
+ python3 <skill_dir>/scripts/docx_to_pdf.py --input in.docx --output "$TMPDIR_DOCX/docx-render.pdf"
238
+ python3 <skill_dir>/scripts/render_docx_pages.py in.docx --output-dir "$TMPDIR_DOCX/docx-pages"
239
+ ```
240
+
241
+ On Windows substitute `python3` -> `python`, `/` -> `\`, and `$TMPDIR_DOCX` -> `$env:TEMP`. The
242
+ underlying `.py` scripts use `tempfile.TemporaryDirectory` and `Path(...).expanduser().resolve()`
243
+ so they do not care which slash style you pass in.
244
+
245
+ ## Structural non-negotiables
246
+
247
+ - `w:p` = `pPr` -> runs
248
+ - `w:r` = `rPr` -> text-like children
249
+ - `w:tbl` = `tblPr` -> `tblGrid` -> rows
250
+ - `w:body` ends with `sectPr`
251
+ - heading styles need `OutlineLevel`
252
+ - direct formatting contamination must be stripped unless explicitly preserved
253
+ - template and multi-section work must preserve section graph, `titlePg`, and per-section headers/footers
254
+
255
+ ## Out of scope
256
+
257
+ - PDF / PPT deliverables -> use `pdf` / `pptx`
258
+ - casual plain-text drafting with no DOCX output
259
+ - pretending a Word-authored DOCX can be safely round-tripped through pandoc for formal output
@@ -0,0 +1,250 @@
1
+ <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
2
+ <w:styles xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main"
3
+ xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships"
4
+ xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006">
5
+
6
+ <!-- Document Defaults -->
7
+ <w:docDefaults>
8
+ <w:rPrDefault>
9
+ <w:rPr>
10
+ <w:rFonts w:ascii="Times New Roman" w:hAnsi="Times New Roman" w:eastAsia="SimSun" w:cs="Times New Roman" />
11
+ <w:sz w:val="24" />
12
+ <w:szCs w:val="24" />
13
+ <w:lang w:val="en-US" w:eastAsia="zh-CN" w:bidi="ar-SA" />
14
+ </w:rPr>
15
+ </w:rPrDefault>
16
+ <w:pPrDefault>
17
+ <w:pPr>
18
+ <w:spacing w:after="0" w:line="480" w:lineRule="auto" />
19
+ </w:pPr>
20
+ </w:pPrDefault>
21
+ </w:docDefaults>
22
+
23
+ <w:latentStyles w:defLockedState="0" w:defUIPriority="99" w:defSemiHidden="0" w:defUnhideWhenUsed="0" w:defQFormat="0" w:count="376" />
24
+
25
+ <!-- Normal — Times New Roman 12pt, double spaced, first line indent -->
26
+ <w:style w:type="paragraph" w:default="1" w:styleId="Normal">
27
+ <w:name w:val="Normal" />
28
+ <w:qFormat />
29
+ <w:pPr>
30
+ <w:spacing w:after="0" w:line="480" w:lineRule="auto" />
31
+ <w:ind w:firstLine="720" />
32
+ </w:pPr>
33
+ <w:rPr>
34
+ <w:rFonts w:ascii="Times New Roman" w:hAnsi="Times New Roman" />
35
+ <w:sz w:val="24" />
36
+ <w:szCs w:val="24" />
37
+ </w:rPr>
38
+ </w:style>
39
+
40
+ <!-- Default Paragraph Font -->
41
+ <w:style w:type="character" w:default="1" w:styleId="DefaultParagraphFont">
42
+ <w:name w:val="Default Paragraph Font" />
43
+ <w:uiPriority w:val="1" />
44
+ <w:semiHidden />
45
+ <w:unhideWhenUsed />
46
+ </w:style>
47
+
48
+ <!-- Heading 1 — Bold, 14pt, no color, no indent -->
49
+ <w:style w:type="paragraph" w:styleId="Heading1">
50
+ <w:name w:val="heading 1" />
51
+ <w:basedOn w:val="Normal" />
52
+ <w:next w:val="Normal" />
53
+ <w:qFormat />
54
+ <w:uiPriority w:val="9" />
55
+ <w:pPr>
56
+ <w:keepNext />
57
+ <w:keepLines />
58
+ <w:spacing w:before="480" w:after="240" w:line="480" w:lineRule="auto" />
59
+ <w:ind w:firstLine="0" />
60
+ <w:jc w:val="center" />
61
+ <w:outlineLvl w:val="0" />
62
+ </w:pPr>
63
+ <w:rPr>
64
+ <w:b />
65
+ <w:sz w:val="28" />
66
+ <w:szCs w:val="28" />
67
+ </w:rPr>
68
+ </w:style>
69
+
70
+ <!-- Heading 2 — Bold, 13pt -->
71
+ <w:style w:type="paragraph" w:styleId="Heading2">
72
+ <w:name w:val="heading 2" />
73
+ <w:basedOn w:val="Normal" />
74
+ <w:next w:val="Normal" />
75
+ <w:qFormat />
76
+ <w:uiPriority w:val="9" />
77
+ <w:pPr>
78
+ <w:keepNext />
79
+ <w:keepLines />
80
+ <w:spacing w:before="360" w:after="120" w:line="480" w:lineRule="auto" />
81
+ <w:ind w:firstLine="0" />
82
+ <w:outlineLvl w:val="1" />
83
+ </w:pPr>
84
+ <w:rPr>
85
+ <w:b />
86
+ <w:sz w:val="26" />
87
+ <w:szCs w:val="26" />
88
+ </w:rPr>
89
+ </w:style>
90
+
91
+ <!-- Heading 3 — Bold, 12pt -->
92
+ <w:style w:type="paragraph" w:styleId="Heading3">
93
+ <w:name w:val="heading 3" />
94
+ <w:basedOn w:val="Normal" />
95
+ <w:next w:val="Normal" />
96
+ <w:qFormat />
97
+ <w:uiPriority w:val="9" />
98
+ <w:pPr>
99
+ <w:keepNext />
100
+ <w:keepLines />
101
+ <w:spacing w:before="240" w:after="80" w:line="480" w:lineRule="auto" />
102
+ <w:ind w:firstLine="0" />
103
+ <w:outlineLvl w:val="2" />
104
+ </w:pPr>
105
+ <w:rPr>
106
+ <w:b />
107
+ <w:sz w:val="24" />
108
+ <w:szCs w:val="24" />
109
+ </w:rPr>
110
+ </w:style>
111
+
112
+ <!-- Title — Centered, bold, 14pt (academic title page) -->
113
+ <w:style w:type="paragraph" w:styleId="Title">
114
+ <w:name w:val="Title" />
115
+ <w:basedOn w:val="Normal" />
116
+ <w:next w:val="Normal" />
117
+ <w:qFormat />
118
+ <w:uiPriority w:val="10" />
119
+ <w:pPr>
120
+ <w:spacing w:after="480" w:line="480" w:lineRule="auto" />
121
+ <w:ind w:firstLine="0" />
122
+ <w:jc w:val="center" />
123
+ </w:pPr>
124
+ <w:rPr>
125
+ <w:b />
126
+ <w:sz w:val="28" />
127
+ <w:szCs w:val="28" />
128
+ </w:rPr>
129
+ </w:style>
130
+
131
+ <!-- Subtitle -->
132
+ <w:style w:type="paragraph" w:styleId="Subtitle">
133
+ <w:name w:val="Subtitle" />
134
+ <w:basedOn w:val="Normal" />
135
+ <w:next w:val="Normal" />
136
+ <w:qFormat />
137
+ <w:uiPriority w:val="11" />
138
+ <w:pPr>
139
+ <w:spacing w:after="240" w:line="480" w:lineRule="auto" />
140
+ <w:ind w:firstLine="0" />
141
+ <w:jc w:val="center" />
142
+ </w:pPr>
143
+ <w:rPr>
144
+ <w:sz w:val="24" />
145
+ <w:szCs w:val="24" />
146
+ </w:rPr>
147
+ </w:style>
148
+
149
+ <!-- Quote — Block quote, indented 0.5 inch on both sides -->
150
+ <w:style w:type="paragraph" w:styleId="Quote">
151
+ <w:name w:val="Quote" />
152
+ <w:basedOn w:val="Normal" />
153
+ <w:next w:val="Normal" />
154
+ <w:qFormat />
155
+ <w:uiPriority w:val="29" />
156
+ <w:pPr>
157
+ <w:spacing w:before="240" w:after="240" w:line="480" w:lineRule="auto" />
158
+ <w:ind w:left="720" w:right="720" w:firstLine="0" />
159
+ </w:pPr>
160
+ </w:style>
161
+
162
+ <!-- Table Normal -->
163
+ <w:style w:type="table" w:default="1" w:styleId="TableNormal">
164
+ <w:name w:val="Normal Table" />
165
+ <w:uiPriority w:val="99" />
166
+ <w:semiHidden />
167
+ <w:unhideWhenUsed />
168
+ <w:tblPr>
169
+ <w:tblInd w:w="0" w:type="dxa" />
170
+ <w:tblCellMar>
171
+ <w:top w:w="0" w:type="dxa" />
172
+ <w:left w:w="108" w:type="dxa" />
173
+ <w:bottom w:w="0" w:type="dxa" />
174
+ <w:right w:w="108" w:type="dxa" />
175
+ </w:tblCellMar>
176
+ </w:tblPr>
177
+ </w:style>
178
+
179
+ <!-- Table Grid — Simple borders, no color -->
180
+ <w:style w:type="table" w:styleId="TableGrid">
181
+ <w:name w:val="Table Grid" />
182
+ <w:basedOn w:val="TableNormal" />
183
+ <w:uiPriority w:val="39" />
184
+ <w:tblPr>
185
+ <w:tblBorders>
186
+ <w:top w:val="single" w:sz="4" w:space="0" w:color="auto" />
187
+ <w:left w:val="single" w:sz="4" w:space="0" w:color="auto" />
188
+ <w:bottom w:val="single" w:sz="4" w:space="0" w:color="auto" />
189
+ <w:right w:val="single" w:sz="4" w:space="0" w:color="auto" />
190
+ <w:insideH w:val="single" w:sz="4" w:space="0" w:color="auto" />
191
+ <w:insideV w:val="single" w:sz="4" w:space="0" w:color="auto" />
192
+ </w:tblBorders>
193
+ </w:tblPr>
194
+ </w:style>
195
+
196
+ <!-- Header -->
197
+ <w:style w:type="paragraph" w:styleId="Header">
198
+ <w:name w:val="header" />
199
+ <w:basedOn w:val="Normal" />
200
+ <w:uiPriority w:val="99" />
201
+ <w:semiHidden />
202
+ <w:unhideWhenUsed />
203
+ <w:pPr>
204
+ <w:tabs>
205
+ <w:tab w:val="center" w:pos="4680" />
206
+ <w:tab w:val="right" w:pos="9360" />
207
+ </w:tabs>
208
+ <w:spacing w:after="0" w:line="240" w:lineRule="auto" />
209
+ <w:ind w:firstLine="0" />
210
+ </w:pPr>
211
+ <w:rPr>
212
+ <w:sz w:val="24" />
213
+ <w:szCs w:val="24" />
214
+ </w:rPr>
215
+ </w:style>
216
+
217
+ <!-- Footer -->
218
+ <w:style w:type="paragraph" w:styleId="Footer">
219
+ <w:name w:val="footer" />
220
+ <w:basedOn w:val="Normal" />
221
+ <w:uiPriority w:val="99" />
222
+ <w:semiHidden />
223
+ <w:unhideWhenUsed />
224
+ <w:pPr>
225
+ <w:tabs>
226
+ <w:tab w:val="center" w:pos="4680" />
227
+ <w:tab w:val="right" w:pos="9360" />
228
+ </w:tabs>
229
+ <w:spacing w:after="0" w:line="240" w:lineRule="auto" />
230
+ <w:ind w:firstLine="0" />
231
+ <w:jc w:val="center" />
232
+ </w:pPr>
233
+ <w:rPr>
234
+ <w:sz w:val="24" />
235
+ <w:szCs w:val="24" />
236
+ </w:rPr>
237
+ </w:style>
238
+
239
+ <!-- Hyperlink -->
240
+ <w:style w:type="character" w:styleId="Hyperlink">
241
+ <w:name w:val="Hyperlink" />
242
+ <w:uiPriority w:val="99" />
243
+ <w:unhideWhenUsed />
244
+ <w:rPr>
245
+ <w:color w:val="0563C1" />
246
+ <w:u w:val="single" />
247
+ </w:rPr>
248
+ </w:style>
249
+
250
+ </w:styles>