@1aboveio/skills 0.0.0-stage → 1.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 (633) hide show
  1. package/README.md +30 -2
  2. package/bin/cli.mjs +14 -0
  3. package/bin/select-core.mjs +172 -0
  4. package/package.json +146 -4
  5. package/skills/app-dev/airflow/LICENSE +3 -0
  6. package/skills/app-dev/airflow/SKILL.md +199 -0
  7. package/skills/app-dev/airflow/release-check.mjs +93 -0
  8. package/skills/app-dev/android-foundation/LICENSE +3 -0
  9. package/skills/app-dev/android-foundation/SKILL.md +192 -0
  10. package/skills/app-dev/android-foundation/assets/android-ci-job.yml +217 -0
  11. package/skills/app-dev/android-foundation/references/ci.md +87 -0
  12. package/skills/app-dev/android-foundation/references/gotchas.md +221 -0
  13. package/skills/app-dev/android-foundation/references/setup.md +164 -0
  14. package/skills/app-dev/android-foundation/release-check.mjs +93 -0
  15. package/skills/app-dev/android-foundation/scripts/device-run.sh +176 -0
  16. package/skills/app-dev/android-foundation/scripts/device-run.test.mjs +172 -0
  17. package/skills/app-dev/app-debug/LICENSE +3 -0
  18. package/skills/app-dev/app-debug/SKILL.md +110 -0
  19. package/skills/app-dev/app-debug/references/common-errors.md +128 -0
  20. package/skills/app-dev/app-debug/release-check.mjs +93 -0
  21. package/skills/app-dev/better-auth/LICENSE +3 -0
  22. package/skills/app-dev/better-auth/SKILL.md +598 -0
  23. package/skills/app-dev/better-auth/references/feishu-api.md +270 -0
  24. package/skills/app-dev/better-auth/release-check.mjs +93 -0
  25. package/skills/app-dev/data-catalog/LICENSE +3 -0
  26. package/skills/app-dev/data-catalog/SKILL.md +204 -0
  27. package/skills/app-dev/data-catalog/agents/openai.yaml +3 -0
  28. package/skills/app-dev/data-catalog/references/data-catalog-conventions.md +75 -0
  29. package/skills/app-dev/data-catalog/references/field-definitions.md +116 -0
  30. package/skills/app-dev/data-catalog/references/format.md +121 -0
  31. package/skills/app-dev/data-catalog/release-check.mjs +93 -0
  32. package/skills/app-dev/data-catalog/scripts/data-catalog.test.mjs +36 -0
  33. package/skills/app-dev/data-catalog/scripts/data_catalog.py +1392 -0
  34. package/skills/app-dev/data-catalog/scripts/persist-conventions-core.mjs +117 -0
  35. package/skills/app-dev/data-catalog/scripts/persist-conventions.mjs +17 -0
  36. package/skills/app-dev/data-catalog/scripts/test_data_catalog.py +571 -0
  37. package/skills/app-dev/ios-foundation/LICENSE +3 -0
  38. package/skills/app-dev/ios-foundation/SKILL.md +184 -0
  39. package/skills/app-dev/ios-foundation/references/setup.md +243 -0
  40. package/skills/app-dev/ios-foundation/release-check.mjs +93 -0
  41. package/skills/app-dev/monorepo/LICENSE +3 -0
  42. package/skills/app-dev/monorepo/SKILL.md +462 -0
  43. package/skills/app-dev/monorepo/release-check.mjs +93 -0
  44. package/skills/app-dev/nextjs-fullstack/LICENSE +3 -0
  45. package/skills/app-dev/nextjs-fullstack/SKILL.md +211 -0
  46. package/skills/app-dev/nextjs-fullstack/conventions.md +318 -0
  47. package/skills/app-dev/nextjs-fullstack/frontend-conventions.md +61 -0
  48. package/skills/app-dev/nextjs-fullstack/nextjs16.md +287 -0
  49. package/skills/app-dev/nextjs-fullstack/release-check.mjs +93 -0
  50. package/skills/app-dev/nextjs-fullstack/server-actions.md +409 -0
  51. package/skills/app-dev/prisma-setup/LICENSE +3 -0
  52. package/skills/app-dev/prisma-setup/SKILL.md +181 -0
  53. package/skills/app-dev/prisma-setup/nextjs.md +258 -0
  54. package/skills/app-dev/prisma-setup/release-check.mjs +93 -0
  55. package/skills/app-dev/prisma-setup/turborepo.md +301 -0
  56. package/skills/app-dev/pyspark/LICENSE +3 -0
  57. package/skills/app-dev/pyspark/SKILL.md +127 -0
  58. package/skills/app-dev/pyspark/assets/templates/etl.py +748 -0
  59. package/skills/app-dev/pyspark/assets/templates/utils/__init__.py +1 -0
  60. package/skills/app-dev/pyspark/assets/templates/utils/hudi_metadata.py +14 -0
  61. package/skills/app-dev/pyspark/references/diagnosis-and-profiling.md +169 -0
  62. package/skills/app-dev/pyspark/references/etl-contract.md +129 -0
  63. package/skills/app-dev/pyspark/references/production-validation.md +131 -0
  64. package/skills/app-dev/pyspark/references/reconciliation.md +38 -0
  65. package/skills/app-dev/pyspark/references/transformation-design.md +190 -0
  66. package/skills/app-dev/pyspark/references/velocity-feature-calculation.md +193 -0
  67. package/skills/app-dev/pyspark/release-check.mjs +93 -0
  68. package/skills/app-dev/pyspark/scripts/spark_eventlog_summary.py +223 -0
  69. package/skills/app-dev/python-backend/LICENSE +3 -0
  70. package/skills/app-dev/python-backend/SKILL.md +325 -0
  71. package/skills/app-dev/python-backend/assets/uv-install.sh +48 -0
  72. package/skills/app-dev/python-backend/references/uv-installs.md +83 -0
  73. package/skills/app-dev/python-backend/release-check.mjs +93 -0
  74. package/skills/app-dev/shadcn/LICENSE +3 -0
  75. package/skills/app-dev/shadcn/SKILL.md +120 -0
  76. package/skills/app-dev/shadcn/assets/shadcn-small.png +0 -0
  77. package/skills/app-dev/shadcn/assets/shadcn.png +0 -0
  78. package/skills/app-dev/shadcn/cli.md +411 -0
  79. package/skills/app-dev/shadcn/customization.md +224 -0
  80. package/skills/app-dev/shadcn/mcp.md +101 -0
  81. package/skills/app-dev/shadcn/release-check.mjs +93 -0
  82. package/skills/app-dev/shadcn/rules/base-vs-radix.md +323 -0
  83. package/skills/app-dev/shadcn/rules/component-selection.md +67 -0
  84. package/skills/app-dev/shadcn/rules/composition.md +195 -0
  85. package/skills/app-dev/shadcn/rules/data-table.md +201 -0
  86. package/skills/app-dev/shadcn/rules/forms.md +255 -0
  87. package/skills/app-dev/shadcn/rules/icons.md +103 -0
  88. package/skills/app-dev/shadcn/rules/styling.md +167 -0
  89. package/skills/app-dev/zod-v4/LICENSE +3 -0
  90. package/skills/app-dev/zod-v4/SKILL.md +286 -0
  91. package/skills/app-dev/zod-v4/release-check.mjs +93 -0
  92. package/skills/cicd/cloud-build/LICENSE +3 -0
  93. package/skills/cicd/cloud-build/SKILL.md +707 -0
  94. package/skills/cicd/cloud-build/release-check.mjs +93 -0
  95. package/skills/cicd/cloud-debug/LICENSE +3 -0
  96. package/skills/cicd/cloud-debug/SKILL.md +315 -0
  97. package/skills/cicd/cloud-debug/references/build-failures.md +238 -0
  98. package/skills/cicd/cloud-debug/references/deploy-failures.md +376 -0
  99. package/skills/cicd/cloud-debug/references/pipeline-failures.md +378 -0
  100. package/skills/cicd/cloud-debug/release-check.mjs +93 -0
  101. package/skills/cicd/cloud-deploy/LICENSE +3 -0
  102. package/skills/cicd/cloud-deploy/SKILL.md +230 -0
  103. package/skills/cicd/cloud-deploy/references/config-templates.md +257 -0
  104. package/skills/cicd/cloud-deploy/release-check.mjs +93 -0
  105. package/skills/cicd/docker/LICENSE +3 -0
  106. package/skills/cicd/docker/SKILL.md +151 -0
  107. package/skills/cicd/docker/release-check.mjs +93 -0
  108. package/skills/cicd/github-actions/LICENSE +3 -0
  109. package/skills/cicd/github-actions/SKILL.md +111 -0
  110. package/skills/cicd/github-actions/references/audit-profile-optimize.md +150 -0
  111. package/skills/cicd/github-actions/references/ci-case-studies.md +141 -0
  112. package/skills/cicd/github-actions/references/conditional-ci.md +214 -0
  113. package/skills/cicd/github-actions/references/debugging.md +13 -0
  114. package/skills/cicd/github-actions/references/pipeline.md +87 -0
  115. package/skills/cicd/github-actions/references/post-deploy-and-publishing.md +33 -0
  116. package/skills/cicd/github-actions/references/runners.md +253 -0
  117. package/skills/cicd/github-actions/references/security.md +29 -0
  118. package/skills/cicd/github-actions/references/speed-and-audit.md +115 -0
  119. package/skills/cicd/github-actions/references/two-pass-reading.md +92 -0
  120. package/skills/cicd/github-actions/release-check.mjs +93 -0
  121. package/skills/cicd/github-actions/scripts/ci-run-audit-core.mjs +612 -0
  122. package/skills/cicd/github-actions/scripts/ci-run-audit.mjs +4 -0
  123. package/skills/cicd/github-actions/scripts/ci-run-audit.test.mjs +637 -0
  124. package/skills/cicd/github-flow/LICENSE +3 -0
  125. package/skills/cicd/github-flow/SKILL.md +123 -0
  126. package/skills/cicd/github-flow/references/ci-conventions.md +14 -0
  127. package/skills/cicd/github-flow/release-check.mjs +93 -0
  128. package/skills/cicd/github-flow/scripts/flow-core.mjs +105 -0
  129. package/skills/cicd/github-flow/scripts/flow.mjs +81 -0
  130. package/skills/cicd/github-flow/scripts/flow.test.mjs +114 -0
  131. package/skills/cicd/github-flow/scripts/persist-conventions-core.mjs +117 -0
  132. package/skills/cicd/github-flow/scripts/persist-conventions.mjs +49 -0
  133. package/skills/cicd/github-flow/scripts/persist-conventions.test.mjs +108 -0
  134. package/skills/cicd/google-cloud/LICENSE +3 -0
  135. package/skills/cicd/google-cloud/SKILL.md +119 -0
  136. package/skills/cicd/google-cloud/references/gcs.md +469 -0
  137. package/skills/cicd/google-cloud/references/iam.md +451 -0
  138. package/skills/cicd/google-cloud/references/project.md +349 -0
  139. package/skills/cicd/google-cloud/references/secrets.md +336 -0
  140. package/skills/cicd/google-cloud/references/vpc.md +312 -0
  141. package/skills/cicd/google-cloud/release-check.mjs +93 -0
  142. package/skills/cicd/google-cloud/scripts/create-sa.sh +36 -0
  143. package/skills/cicd/google-cloud/scripts/gcp-config.sh +31 -0
  144. package/skills/cicd/google-cloud/scripts/grant-iap.sh +41 -0
  145. package/skills/cicd/google-cloud/scripts/setup-secrets.sh +48 -0
  146. package/skills/cicd/mergify/LICENSE +3 -0
  147. package/skills/cicd/mergify/SKILL.md +102 -0
  148. package/skills/cicd/mergify/assets/templates/mergify.yml +215 -0
  149. package/skills/cicd/mergify/assets/templates/ruleset.json +46 -0
  150. package/skills/cicd/mergify/references/branch-protection.md +282 -0
  151. package/skills/cicd/mergify/references/configuration.md +274 -0
  152. package/skills/cicd/mergify/references/diagnosis.md +109 -0
  153. package/skills/cicd/mergify/references/stacks.md +84 -0
  154. package/skills/cicd/mergify/references/traps.md +119 -0
  155. package/skills/cicd/mergify/references/watch-contract.md +274 -0
  156. package/skills/cicd/mergify/release-check.mjs +93 -0
  157. package/skills/cicd/mergify/scripts/audit-core.mjs +208 -0
  158. package/skills/cicd/mergify/scripts/audit.mjs +4 -0
  159. package/skills/cicd/mergify/scripts/audit.test.mjs +201 -0
  160. package/skills/cicd/mergify/scripts/entrypoints.test.mjs +106 -0
  161. package/skills/cicd/mergify/scripts/pr-620-mergify-comments.fixture.json +30 -0
  162. package/skills/cicd/mergify/scripts/stack-push-core.mjs +258 -0
  163. package/skills/cicd/mergify/scripts/stack-push.mjs +4 -0
  164. package/skills/cicd/mergify/scripts/stack-push.test.mjs +233 -0
  165. package/skills/cicd/mergify/scripts/watch-pr-delivery-core.mjs +1065 -0
  166. package/skills/cicd/mergify/scripts/watch-pr-delivery.mjs +4 -0
  167. package/skills/cicd/mergify/scripts/watch-pr-delivery.test.mjs +1826 -0
  168. package/skills/cicd/podman/LICENSE +3 -0
  169. package/skills/cicd/podman/SKILL.md +71 -0
  170. package/skills/cicd/podman/agents/openai.yaml +4 -0
  171. package/skills/cicd/podman/assets/templates/podman-compose-socket-directory.yml +6 -0
  172. package/skills/cicd/podman/assets/templates/podman-service-override.conf +3 -0
  173. package/skills/cicd/podman/references/compose-compatibility.md +70 -0
  174. package/skills/cicd/podman/references/networking-and-ports.md +74 -0
  175. package/skills/cicd/podman/references/rootless-services-and-sockets.md +156 -0
  176. package/skills/cicd/podman/references/troubleshooting.md +98 -0
  177. package/skills/cicd/podman/release-check.mjs +93 -0
  178. package/skills/content/article-review/LICENSE +3 -0
  179. package/skills/content/article-review/SKILL.md +66 -0
  180. package/skills/content/article-review/references/report-format.md +68 -0
  181. package/skills/content/article-review/references/template-guide.md +79 -0
  182. package/skills/content/article-review/references/template-wechat-payments.md +125 -0
  183. package/skills/content/article-review/release-check.mjs +93 -0
  184. package/skills/content/article-to-image/LICENSE +3 -0
  185. package/skills/content/article-to-image/SKILL.md +91 -0
  186. package/skills/content/article-to-image/references/formats.md +53 -0
  187. package/skills/content/article-to-image/release-check.mjs +93 -0
  188. package/skills/content/flowchart-svg/LICENSE +3 -0
  189. package/skills/content/flowchart-svg/SKILL.md +43 -0
  190. package/skills/content/flowchart-svg/release-check.mjs +93 -0
  191. package/skills/content/flowchart-svg/scripts/export_png.sh +8 -0
  192. package/skills/content/image-gen/LICENSE +3 -0
  193. package/skills/content/image-gen/SKILL.md +192 -0
  194. package/skills/content/image-gen/release-check.mjs +93 -0
  195. package/skills/content/image-gen/scripts/credentials.mjs +217 -0
  196. package/skills/content/image-gen/scripts/credentials.test.mjs +212 -0
  197. package/skills/content/image-gen/scripts/generate.mjs +240 -0
  198. package/skills/content/image-gen/scripts/options.mjs +293 -0
  199. package/skills/content/image-gen/scripts/options.test.mjs +245 -0
  200. package/skills/content/mermaid/LICENSE +3 -0
  201. package/skills/content/mermaid/SKILL.md +635 -0
  202. package/skills/content/mermaid/release-check.mjs +93 -0
  203. package/skills/content/wechat-article-writer/LICENSE +3 -0
  204. package/skills/content/wechat-article-writer/SKILL.md +92 -0
  205. package/skills/content/wechat-article-writer/references/style-selector.md +133 -0
  206. package/skills/content/wechat-article-writer/references/writing-rules.md +152 -0
  207. package/skills/content/wechat-article-writer/release-check.mjs +93 -0
  208. package/skills/content/wechat-article-writer/templates/wechat-comparison.md +52 -0
  209. package/skills/content/wechat-article-writer/templates/wechat-howto.md +51 -0
  210. package/skills/content/wechat-article-writer/templates/wechat-insight.md +50 -0
  211. package/skills/content/wechat-article-writer/templates/wechat-pitfall.md +52 -0
  212. package/skills/content/wechat-publisher/LICENSE +3 -0
  213. package/skills/content/wechat-publisher/SKILL.md +171 -0
  214. package/skills/content/wechat-publisher/references/api.md +105 -0
  215. package/skills/content/wechat-publisher/references/layout-rules.md +57 -0
  216. package/skills/content/wechat-publisher/references/wechat-safe-template.html +86 -0
  217. package/skills/content/wechat-publisher/release-check.mjs +93 -0
  218. package/skills/content/wechat-publisher/scripts/md_to_wechat_html.py +194 -0
  219. package/skills/content/wechat-publisher/scripts/publish.py +239 -0
  220. package/skills/content/wechat-search/LICENSE +3 -0
  221. package/skills/content/wechat-search/SKILL.md +211 -0
  222. package/skills/content/wechat-search/release-check.mjs +93 -0
  223. package/skills/content/wechat-search/scripts/start-chrome.sh +83 -0
  224. package/skills/content/xai-search/LICENSE +3 -0
  225. package/skills/content/xai-search/SKILL.md +79 -0
  226. package/skills/content/xai-search/release-check.mjs +93 -0
  227. package/skills/content/xai-search/scripts/xai_search.sh +187 -0
  228. package/skills/content/xai-search/tests/smoke_test.sh +36 -0
  229. package/skills/core/distill-writing/LICENSE +3 -0
  230. package/skills/core/distill-writing/SKILL.md +74 -0
  231. package/skills/core/distill-writing/references/extraction.md +95 -0
  232. package/skills/core/distill-writing/references/updating.md +46 -0
  233. package/skills/core/distill-writing/release-check.mjs +93 -0
  234. package/skills/core/doc-to-md/LICENSE +3 -0
  235. package/skills/core/doc-to-md/SKILL.md +78 -0
  236. package/skills/core/doc-to-md/release-check.mjs +93 -0
  237. package/skills/core/doc-to-md/scripts/convert.py +157 -0
  238. package/skills/core/editorial-review/LICENSE +3 -0
  239. package/skills/core/editorial-review/SKILL.md +79 -0
  240. package/skills/core/editorial-review/references/checklist.md +94 -0
  241. package/skills/core/editorial-review/release-check.mjs +93 -0
  242. package/skills/core/house-style/LICENSE +3 -0
  243. package/skills/core/house-style/SKILL.md +33 -0
  244. package/skills/core/house-style/references/defaults.md +66 -0
  245. package/skills/core/house-style/references/rules.md +267 -0
  246. package/skills/core/house-style/references/sources.md +27 -0
  247. package/skills/core/house-style/references/style-en.md +131 -0
  248. package/skills/core/house-style/references/style-zh.md +141 -0
  249. package/skills/core/house-style/references/terminology-zh.md +223 -0
  250. package/skills/core/house-style/release-check.mjs +93 -0
  251. package/skills/core/house-style/templates/brd.md +103 -0
  252. package/skills/core/house-style/templates/commercial-proposal.md +93 -0
  253. package/skills/core/house-style/templates/compliance-policy.md +109 -0
  254. package/skills/core/house-style/templates/gap-analysis.md +105 -0
  255. package/skills/core/house-style/templates/general.md +63 -0
  256. package/skills/core/house-style/templates/integration-guide.md +98 -0
  257. package/skills/core/house-style/templates/prd.md +81 -0
  258. package/skills/core/house-style/templates/risk-operations-procedure.md +94 -0
  259. package/skills/core/house-style/templates/technical-spec.md +96 -0
  260. package/skills/core/polish-cn/LICENSE +3 -0
  261. package/skills/core/polish-cn/SKILL.md +102 -0
  262. package/skills/core/polish-cn/references/brief.md +93 -0
  263. package/skills/core/polish-cn/references/models.md +76 -0
  264. package/skills/core/polish-cn/release-check.mjs +93 -0
  265. package/skills/core/polish-cn/scripts/polish-cn.test.mjs +244 -0
  266. package/skills/core/polish-cn/scripts/polish_blocks.py +489 -0
  267. package/skills/core/reg-parser/LICENSE +3 -0
  268. package/skills/core/reg-parser/SKILL.md +212 -0
  269. package/skills/core/reg-parser/references/checklist-schema.md +223 -0
  270. package/skills/core/reg-parser/references/checklists/hk-amlo-checklist.json +1306 -0
  271. package/skills/core/reg-parser/references/checklists/hk-amlo-checklist.md +469 -0
  272. package/skills/core/reg-parser/references/checklists/hk-fi-corporate-onboarding-cdd-checklist.json +634 -0
  273. package/skills/core/reg-parser/references/checklists/hk-fi-corporate-onboarding-cdd-checklist.md +233 -0
  274. package/skills/core/reg-parser/references/checklists/hk-mso-guideline-checklist.json +2194 -0
  275. package/skills/core/reg-parser/references/checklists/hk-mso-guideline-checklist.md +771 -0
  276. package/skills/core/reg-parser/references/checklists/kyc-aml-checklist.md +258 -0
  277. package/skills/core/reg-parser/references/checklists/visa-vars-checklist.md +1058 -0
  278. package/skills/core/reg-parser/references/mandates/hk-amlo-cap615.md +389 -0
  279. package/skills/core/reg-parser/references/mandates/visa-vars.md +205 -0
  280. package/skills/core/reg-parser/release-check.mjs +93 -0
  281. package/skills/core/reg-parser/scripts/compare_checklist.py +230 -0
  282. package/skills/core/reg-parser/scripts/dump_checklist.py +361 -0
  283. package/skills/core/reg-parser/scripts/preprocess-mandate.sh +187 -0
  284. package/skills/core/reg-parser/scripts/reg-parser.test.mjs +165 -0
  285. package/skills/core/reg-parser/scripts/test_quarantine.sh +105 -0
  286. package/skills/core/reg-parser/scripts/validate_checklist.py +563 -0
  287. package/skills/core/reg-parser/scripts/validate_mandate.py +273 -0
  288. package/skills/core/terminology/LICENSE +3 -0
  289. package/skills/core/terminology/SKILL.md +62 -0
  290. package/skills/core/terminology/references/format.md +50 -0
  291. package/skills/core/terminology/references/init.md +32 -0
  292. package/skills/core/terminology/release-check.mjs +93 -0
  293. package/skills/core/write-doc/LICENSE +3 -0
  294. package/skills/core/write-doc/SKILL.md +141 -0
  295. package/skills/core/write-doc/references/bilingual.md +60 -0
  296. package/skills/core/write-doc/release-check.mjs +93 -0
  297. package/skills/engineering/better-review/LICENSE +3 -0
  298. package/skills/engineering/better-review/SKILL.md +249 -0
  299. package/skills/engineering/better-review/agents/openai.yaml +9 -0
  300. package/skills/engineering/better-review/references/domain-hazards.md +53 -0
  301. package/skills/engineering/better-review/references/passes.md +147 -0
  302. package/skills/engineering/better-review/references/result.md +151 -0
  303. package/skills/engineering/better-review/release-check.mjs +93 -0
  304. package/skills/engineering/better-review/scripts/pr-context.mjs +212 -0
  305. package/skills/engineering/better-review/scripts/pr-context.test.mjs +168 -0
  306. package/skills/engineering/better-review/scripts/rereview-scope.mjs +503 -0
  307. package/skills/engineering/better-review/scripts/rereview-scope.test.mjs +587 -0
  308. package/skills/engineering/better-review/scripts/scan-diff.mjs +365 -0
  309. package/skills/engineering/better-review/scripts/scan-diff.test.mjs +414 -0
  310. package/skills/engineering/better-review/scripts/vendor-sync.test.mjs +96 -0
  311. package/skills/engineering/e2e-test/LICENSE +3 -0
  312. package/skills/engineering/e2e-test/SKILL.md +98 -0
  313. package/skills/engineering/e2e-test/assets/ci-gates.cloudbuild.yaml +24 -0
  314. package/skills/engineering/e2e-test/references/authoring/auth-flows.md +159 -0
  315. package/skills/engineering/e2e-test/references/authoring/playwright-config.md +73 -0
  316. package/skills/engineering/e2e-test/references/authoring/playwright-patterns.md +144 -0
  317. package/skills/engineering/e2e-test/references/ci-integration.md +25 -0
  318. package/skills/engineering/e2e-test/references/ci-playwright-container.md +290 -0
  319. package/skills/engineering/e2e-test/references/presentation-sweep.md +104 -0
  320. package/skills/engineering/e2e-test/references/reviewing.md +41 -0
  321. package/skills/engineering/e2e-test/references/route-manifest.md +51 -0
  322. package/skills/engineering/e2e-test/release-check.mjs +93 -0
  323. package/skills/engineering/e2e-test/scripts/detect-routes-nextjs.mjs +200 -0
  324. package/skills/engineering/e2e-test/scripts/presentation-checks.mjs +171 -0
  325. package/skills/engineering/e2e-test/scripts/presentation-checks.test.mjs +106 -0
  326. package/skills/engineering/e2e-test/scripts/presentation-perceivability.mjs +179 -0
  327. package/skills/engineering/e2e-test/scripts/presentation-perceivability.test.mjs +117 -0
  328. package/skills/engineering/e2e-test/scripts/presentation-reachability.mjs +154 -0
  329. package/skills/engineering/e2e-test/scripts/presentation-reachability.test.mjs +69 -0
  330. package/skills/engineering/e2e-test/scripts/presentation-render-health.mjs +141 -0
  331. package/skills/engineering/e2e-test/scripts/presentation-render-health.test.mjs +98 -0
  332. package/skills/engineering/e2e-test/scripts/presentation-sweep.mjs +147 -0
  333. package/skills/engineering/e2e-test/scripts/presentation-sweep.test.mjs +71 -0
  334. package/skills/engineering/e2e-test/scripts/presentation-temporal.mjs +127 -0
  335. package/skills/engineering/e2e-test/scripts/presentation-temporal.test.mjs +59 -0
  336. package/skills/engineering/e2e-test/scripts/project-route-manifest.mjs +82 -0
  337. package/skills/engineering/e2e-test/scripts/project-route-manifest.test.mjs +76 -0
  338. package/skills/engineering/e2e-test/scripts/validate-manifest.mjs +106 -0
  339. package/skills/engineering/engineering-runtime/LICENSE +3 -0
  340. package/skills/engineering/engineering-runtime/SKILL.md +11 -0
  341. package/skills/engineering/engineering-runtime/agents/openai.yaml +6 -0
  342. package/skills/engineering/engineering-runtime/coherence/workflow.json +597 -0
  343. package/skills/engineering/engineering-runtime/engineering-runtime.test.mjs +68 -0
  344. package/skills/engineering/engineering-runtime/release-check.mjs +93 -0
  345. package/skills/engineering/engineering-runtime/scripts/exact-head-artifact.mjs +131 -0
  346. package/skills/engineering/engineering-runtime/scripts/head-check-set.mjs +398 -0
  347. package/skills/engineering/engineering-runtime/scripts/invocation-policy.mjs +187 -0
  348. package/skills/engineering/engineering-runtime/scripts/invocation-policy.test.mjs +95 -0
  349. package/skills/engineering/engineering-runtime/scripts/main-module.mjs +79 -0
  350. package/skills/engineering/engineering-runtime/scripts/main-module.test.mjs +288 -0
  351. package/skills/engineering/engineering-runtime/scripts/mergify-yaml.mjs +11 -0
  352. package/skills/engineering/engineering-runtime/scripts/package-lock.json +43 -0
  353. package/skills/engineering/engineering-runtime/scripts/package.json +10 -0
  354. package/skills/engineering/engineering-runtime/scripts/required-check-plan.mjs +223 -0
  355. package/skills/engineering/engineering-runtime/scripts/required-check-plan.test.mjs +96 -0
  356. package/skills/engineering/engineering-runtime/scripts/review-completion.mjs +56 -0
  357. package/skills/engineering/engineering-runtime/scripts/workflow-coherence.mjs +595 -0
  358. package/skills/engineering/engineering-runtime/scripts/workflow-policy.mjs +189 -0
  359. package/skills/engineering/engineering-runtime/scripts/yaml-mapping.mjs +18 -0
  360. package/skills/engineering/ensure-coverage/LICENSE +3 -0
  361. package/skills/engineering/ensure-coverage/SKILL.md +129 -0
  362. package/skills/engineering/ensure-coverage/references/breadth/coverage-ledger.md +92 -0
  363. package/skills/engineering/ensure-coverage/references/breadth/inventory-contract.md +85 -0
  364. package/skills/engineering/ensure-coverage/references/breadth/surface-baseline.md +44 -0
  365. package/skills/engineering/ensure-coverage/references/breadth/surface-discovery.md +16 -0
  366. package/skills/engineering/ensure-coverage/references/depth/characterization.md +68 -0
  367. package/skills/engineering/ensure-coverage/references/depth/coverage.config.example.json +19 -0
  368. package/skills/engineering/ensure-coverage/references/depth/grading.md +35 -0
  369. package/skills/engineering/ensure-coverage/references/depth/mock-policy.md +57 -0
  370. package/skills/engineering/ensure-coverage/references/depth/test-smells.md +39 -0
  371. package/skills/engineering/ensure-coverage/references/enforcement/ci-contract.md +44 -0
  372. package/skills/engineering/ensure-coverage/references/examples/coverage-ledger.md +110 -0
  373. package/skills/engineering/ensure-coverage/references/examples/refund-flow.md +35 -0
  374. package/skills/engineering/ensure-coverage/references/presentation/axis.md +64 -0
  375. package/skills/engineering/ensure-coverage/references/process/audit-mode.md +27 -0
  376. package/skills/engineering/ensure-coverage/references/process/output-template.md +139 -0
  377. package/skills/engineering/ensure-coverage/references/process/test-strategy.md +56 -0
  378. package/skills/engineering/ensure-coverage/release-check.mjs +93 -0
  379. package/skills/engineering/ensure-coverage/schemas/coverage-config.schema.json +67 -0
  380. package/skills/engineering/ensure-coverage/schemas/coverage-file.schema.json +140 -0
  381. package/skills/engineering/ensure-coverage/scripts/README.md +99 -0
  382. package/skills/engineering/ensure-coverage/scripts/adapters/nextjs-inventory.mjs +182 -0
  383. package/skills/engineering/ensure-coverage/scripts/adapters/nextjs-inventory.test.mjs +96 -0
  384. package/skills/engineering/ensure-coverage/scripts/check-quarantine-expiry.mjs +105 -0
  385. package/skills/engineering/ensure-coverage/scripts/check-quarantine-expiry.test.mjs +47 -0
  386. package/skills/engineering/ensure-coverage/scripts/ci-audit.mjs +137 -0
  387. package/skills/engineering/ensure-coverage/scripts/ci-audit.test.mjs +86 -0
  388. package/skills/engineering/ensure-coverage/scripts/coverage-ledger.mjs +674 -0
  389. package/skills/engineering/ensure-coverage/scripts/coverage-ledger.test.mjs +447 -0
  390. package/skills/engineering/ensure-coverage/scripts/design-parity.mjs +591 -0
  391. package/skills/engineering/ensure-coverage/scripts/design-parity.test.mjs +552 -0
  392. package/skills/engineering/ensure-coverage/scripts/lint-tests.mjs +282 -0
  393. package/skills/engineering/ensure-coverage/scripts/lint-tests.test.mjs +289 -0
  394. package/skills/engineering/ensure-coverage/scripts/mock-policy-config.mjs +176 -0
  395. package/skills/engineering/ensure-coverage/scripts/mock-policy-config.test.mjs +119 -0
  396. package/skills/engineering/ensure-coverage/scripts/package.json +19 -0
  397. package/skills/engineering/golden-path/LICENSE +3 -0
  398. package/skills/engineering/golden-path/SKILL.md +230 -0
  399. package/skills/engineering/golden-path/agents/openai.yaml +3 -0
  400. package/skills/engineering/golden-path/assets/golden-paths.example.json +57 -0
  401. package/skills/engineering/golden-path/references/contract.md +239 -0
  402. package/skills/engineering/golden-path/references/migration.md +111 -0
  403. package/skills/engineering/golden-path/release-check.mjs +93 -0
  404. package/skills/engineering/golden-path/scripts/golden-path-core.mjs +1779 -0
  405. package/skills/engineering/golden-path/scripts/golden-path.mjs +6 -0
  406. package/skills/engineering/golden-path/scripts/golden-path.test.mjs +1457 -0
  407. package/skills/engineering/harness-runtime/LICENSE +3 -0
  408. package/skills/engineering/harness-runtime/SKILL.md +19 -0
  409. package/skills/engineering/harness-runtime/agents/openai.yaml +6 -0
  410. package/skills/engineering/harness-runtime/bin/discover-models.mjs +4 -0
  411. package/skills/engineering/harness-runtime/bin/model-catalog.mjs +4 -0
  412. package/skills/engineering/harness-runtime/contracts.md +15 -0
  413. package/skills/engineering/harness-runtime/discover-models.mjs +392 -0
  414. package/skills/engineering/harness-runtime/discover-models.test.mjs +363 -0
  415. package/skills/engineering/harness-runtime/fixtures/native-question-schemas.json +33 -0
  416. package/skills/engineering/harness-runtime/fixtures/question-responses.json +54 -0
  417. package/skills/engineering/harness-runtime/harness-runtime.test.mjs +967 -0
  418. package/skills/engineering/harness-runtime/index.mjs +767 -0
  419. package/skills/engineering/harness-runtime/model-catalog-seed.test.mjs +829 -0
  420. package/skills/engineering/harness-runtime/model-catalog.mjs +787 -0
  421. package/skills/engineering/harness-runtime/model-catalog.test.mjs +366 -0
  422. package/skills/engineering/harness-runtime/native-question-contracts.md +37 -0
  423. package/skills/engineering/harness-runtime/references/model-catalog-seed.json +408 -0
  424. package/skills/engineering/harness-runtime/references/model-catalog.md +57 -0
  425. package/skills/engineering/harness-runtime/release-check.mjs +93 -0
  426. package/skills/engineering/resolve-issues/LICENSE +3 -0
  427. package/skills/engineering/resolve-issues/SKILL.md +250 -0
  428. package/skills/engineering/resolve-issues/agents/openai.yaml +9 -0
  429. package/skills/engineering/resolve-issues/plugin-hooks.json +17 -0
  430. package/skills/engineering/resolve-issues/references/canary.md +28 -0
  431. package/skills/engineering/resolve-issues/references/ci.md +105 -0
  432. package/skills/engineering/resolve-issues/references/done.md +25 -0
  433. package/skills/engineering/resolve-issues/references/dropbox.md +90 -0
  434. package/skills/engineering/resolve-issues/references/expire.md +318 -0
  435. package/skills/engineering/resolve-issues/references/exploration.md +202 -0
  436. package/skills/engineering/resolve-issues/references/implementation.md +303 -0
  437. package/skills/engineering/resolve-issues/references/preflight.md +445 -0
  438. package/skills/engineering/resolve-issues/references/review.md +228 -0
  439. package/skills/engineering/resolve-issues/references/shared-modules.md +44 -0
  440. package/skills/engineering/resolve-issues/references/task-plan.md +264 -0
  441. package/skills/engineering/resolve-issues/release-check.mjs +93 -0
  442. package/skills/engineering/resolve-issues/scripts/cleanup-runs.mjs +364 -0
  443. package/skills/engineering/resolve-issues/scripts/cleanup-runs.test.mjs +280 -0
  444. package/skills/engineering/resolve-issues/scripts/discover-models.mjs +9 -0
  445. package/skills/engineering/resolve-issues/scripts/dropbox.mjs +473 -0
  446. package/skills/engineering/resolve-issues/scripts/dropbox.test.mjs +346 -0
  447. package/skills/engineering/resolve-issues/scripts/findings-reuse.mjs +98 -0
  448. package/skills/engineering/resolve-issues/scripts/findings-reuse.test.mjs +88 -0
  449. package/skills/engineering/resolve-issues/scripts/github-reviews.mjs +384 -0
  450. package/skills/engineering/resolve-issues/scripts/github-reviews.test.mjs +264 -0
  451. package/skills/engineering/resolve-issues/scripts/install-hooks.mjs +135 -0
  452. package/skills/engineering/resolve-issues/scripts/install-hooks.test.mjs +79 -0
  453. package/skills/engineering/resolve-issues/scripts/issue-tree.mjs +162 -0
  454. package/skills/engineering/resolve-issues/scripts/issue-tree.test.mjs +107 -0
  455. package/skills/engineering/resolve-issues/scripts/manual-invocation.test.mjs +14 -0
  456. package/skills/engineering/resolve-issues/scripts/model-catalog.mjs +9 -0
  457. package/skills/engineering/resolve-issues/scripts/next-actions-capacity.test.mjs +149 -0
  458. package/skills/engineering/resolve-issues/scripts/next-actions.mjs +856 -0
  459. package/skills/engineering/resolve-issues/scripts/next-actions.test.mjs +915 -0
  460. package/skills/engineering/resolve-issues/scripts/plan-sync.mjs +269 -0
  461. package/skills/engineering/resolve-issues/scripts/plan-sync.test.mjs +156 -0
  462. package/skills/engineering/resolve-issues/scripts/preflight-models.mjs +736 -0
  463. package/skills/engineering/resolve-issues/scripts/preflight-models.test.mjs +448 -0
  464. package/skills/engineering/resolve-issues/scripts/ready-check.mjs +185 -0
  465. package/skills/engineering/resolve-issues/scripts/ready-check.test.mjs +217 -0
  466. package/skills/engineering/resolve-issues/scripts/rehydrate.mjs +98 -0
  467. package/skills/engineering/resolve-issues/scripts/rehydrate.test.mjs +91 -0
  468. package/skills/engineering/resolve-issues/scripts/review-verdict.mjs +509 -0
  469. package/skills/engineering/resolve-issues/scripts/review-verdict.test.mjs +1060 -0
  470. package/skills/engineering/resolve-issues/scripts/size-check.mjs +492 -0
  471. package/skills/engineering/resolve-issues/scripts/size-check.test.mjs +458 -0
  472. package/skills/engineering/resolve-release/LICENSE +3 -0
  473. package/skills/engineering/resolve-release/SKILL.md +215 -0
  474. package/skills/engineering/resolve-release/agents/openai.yaml +8 -0
  475. package/skills/engineering/resolve-release/flows/cloud-run-canary.md +13 -0
  476. package/skills/engineering/resolve-release/flows/cloud-run.md +7 -0
  477. package/skills/engineering/resolve-release/flows/root-tag-npm.md +13 -0
  478. package/skills/engineering/resolve-release/flows/workspace-npm.md +22 -0
  479. package/skills/engineering/resolve-release/references/canary.md +51 -0
  480. package/skills/engineering/resolve-release/references/candidate.md +41 -0
  481. package/skills/engineering/resolve-release/references/cut.md +131 -0
  482. package/skills/engineering/resolve-release/references/dark-launch.md +66 -0
  483. package/skills/engineering/resolve-release/references/flows.md +150 -0
  484. package/skills/engineering/resolve-release/references/preflight.md +154 -0
  485. package/skills/engineering/resolve-release/references/prepared-metadata.md +260 -0
  486. package/skills/engineering/resolve-release/references/promotion.md +82 -0
  487. package/skills/engineering/resolve-release/references/publish.md +232 -0
  488. package/skills/engineering/resolve-release/references/workspace-npm.md +103 -0
  489. package/skills/engineering/resolve-release/release-check.mjs +93 -0
  490. package/skills/engineering/resolve-release/scripts/apply.mjs +212 -0
  491. package/skills/engineering/resolve-release/scripts/apply.test.mjs +99 -0
  492. package/skills/engineering/resolve-release/scripts/dark-flags.mjs +134 -0
  493. package/skills/engineering/resolve-release/scripts/dark-flags.test.mjs +100 -0
  494. package/skills/engineering/resolve-release/scripts/flow.mjs +500 -0
  495. package/skills/engineering/resolve-release/scripts/flow.test.mjs +340 -0
  496. package/skills/engineering/resolve-release/scripts/green-head.mjs +231 -0
  497. package/skills/engineering/resolve-release/scripts/green-head.test.mjs +101 -0
  498. package/skills/engineering/resolve-release/scripts/npm-version-absence.mjs +138 -0
  499. package/skills/engineering/resolve-release/scripts/npm-version-absence.test.mjs +426 -0
  500. package/skills/engineering/resolve-release/scripts/plan-npm.test.mjs +659 -0
  501. package/skills/engineering/resolve-release/scripts/plan-toml-boundary.test.mjs +317 -0
  502. package/skills/engineering/resolve-release/scripts/plan-uv.test.mjs +291 -0
  503. package/skills/engineering/resolve-release/scripts/plan.mjs +806 -0
  504. package/skills/engineering/resolve-release/scripts/plan.test.mjs +428 -0
  505. package/skills/engineering/rush-issues/LICENSE +3 -0
  506. package/skills/engineering/rush-issues/SKILL.md +58 -0
  507. package/skills/engineering/rush-issues/agents/openai.yaml +8 -0
  508. package/skills/engineering/rush-issues/rehydrate.mjs +10 -0
  509. package/skills/engineering/rush-issues/release-check.mjs +93 -0
  510. package/skills/engineering/rush-release/LICENSE +3 -0
  511. package/skills/engineering/rush-release/SKILL.md +35 -0
  512. package/skills/engineering/rush-release/agents/openai.yaml +8 -0
  513. package/skills/engineering/rush-release/release-check.mjs +93 -0
  514. package/skills/engineering/test-quality/LICENSE +3 -0
  515. package/skills/engineering/test-quality/SKILL.md +79 -0
  516. package/skills/engineering/test-quality/references/audit.md +80 -0
  517. package/skills/engineering/test-quality/references/lint.md +24 -0
  518. package/skills/engineering/test-quality/references/principles.md +143 -0
  519. package/skills/engineering/test-quality/references/testing-conventions.md +9 -0
  520. package/skills/engineering/test-quality/release-check.mjs +93 -0
  521. package/skills/engineering/test-quality/scripts/lint-tests.mjs +574 -0
  522. package/skills/engineering/test-quality/scripts/lint-tests.test.mjs +591 -0
  523. package/skills/engineering/test-quality/scripts/mock-policy-config.mjs +176 -0
  524. package/skills/engineering/test-quality/scripts/mock-policy-config.test.mjs +119 -0
  525. package/skills/engineering/test-quality/scripts/persist-conventions-core.mjs +117 -0
  526. package/skills/engineering/test-quality/scripts/persist-conventions.mjs +17 -0
  527. package/skills/engineering/test-quality/scripts/persist-conventions.test.mjs +104 -0
  528. package/skills/risk-compliance/compliance-audit/LICENSE +3 -0
  529. package/skills/risk-compliance/compliance-audit/SKILL.md +439 -0
  530. package/skills/risk-compliance/compliance-audit/references/findings-schema.md +293 -0
  531. package/skills/risk-compliance/compliance-audit/references/normalization-rules.md +45 -0
  532. package/skills/risk-compliance/compliance-audit/references/vars-checklist.md +1068 -0
  533. package/skills/risk-compliance/compliance-audit/references/vars-findings-schema.md +398 -0
  534. package/skills/risk-compliance/compliance-audit/release-check.mjs +93 -0
  535. package/skills/risk-compliance/compliance-audit/scripts/compliance-audit.test.mjs +14 -0
  536. package/skills/risk-compliance/compliance-audit/scripts/export_tracker_xlsx.py +221 -0
  537. package/skills/risk-compliance/compliance-audit/scripts/reconcile_tracker.py +458 -0
  538. package/skills/risk-compliance/compliance-audit/scripts/test_export_tracker_xlsx.py +97 -0
  539. package/skills/risk-compliance/compliance-audit/scripts/test_validate_tracker.py +157 -0
  540. package/skills/risk-compliance/compliance-audit/scripts/validate_tracker.py +829 -0
  541. package/skills/risk-compliance/contract-compare/LICENSE +3 -0
  542. package/skills/risk-compliance/contract-compare/SKILL.md +199 -0
  543. package/skills/risk-compliance/contract-compare/references/comparison-dimensions.md +209 -0
  544. package/skills/risk-compliance/contract-compare/release-check.mjs +93 -0
  545. package/skills/risk-compliance/contract-review/LICENSE +3 -0
  546. package/skills/risk-compliance/contract-review/SKILL.md +240 -0
  547. package/skills/risk-compliance/contract-review/references/review-criteria.md +223 -0
  548. package/skills/risk-compliance/contract-review/release-check.mjs +93 -0
  549. package/skills/risk-compliance/doc-authenticity/LICENSE +3 -0
  550. package/skills/risk-compliance/doc-authenticity/SKILL.md +160 -0
  551. package/skills/risk-compliance/doc-authenticity/agents/openai.yaml +8 -0
  552. package/skills/risk-compliance/doc-authenticity/manual-invocation.test.mjs +12 -0
  553. package/skills/risk-compliance/doc-authenticity/references/agreement.md +66 -0
  554. package/skills/risk-compliance/doc-authenticity/references/bank-statement.md +150 -0
  555. package/skills/risk-compliance/doc-authenticity/references/forensic-signals.md +157 -0
  556. package/skills/risk-compliance/doc-authenticity/references/image-signals.md +114 -0
  557. package/skills/risk-compliance/doc-authenticity/references/invoice.md +66 -0
  558. package/skills/risk-compliance/doc-authenticity/references/issuer-profiles.md +86 -0
  559. package/skills/risk-compliance/doc-authenticity/references/verdict-and-report.md +95 -0
  560. package/skills/risk-compliance/doc-authenticity/references/verdict.schema.json +81 -0
  561. package/skills/risk-compliance/doc-authenticity/release-check.mjs +93 -0
  562. package/skills/risk-compliance/doc-authenticity/scripts/image_forensics.py +294 -0
  563. package/skills/risk-compliance/doc-authenticity/scripts/pdf_forensics.py +401 -0
  564. package/skills/risk-compliance/doc-authenticity/scripts/validate_codes.py +224 -0
  565. package/skills/risk-compliance/doc-authenticity/scripts/validate_verdict.py +308 -0
  566. package/skills/risk-compliance/doc-authenticity/scripts/validate_verdict.test.mjs +212 -0
  567. package/skills/risk-compliance/fraud-analysis/LICENSE +3 -0
  568. package/skills/risk-compliance/fraud-analysis/SKILL.md +114 -0
  569. package/skills/risk-compliance/fraud-analysis/references/archetypes/authorized-payment-scam.md +41 -0
  570. package/skills/risk-compliance/fraud-analysis/references/archetypes/first-party-fraud.md +44 -0
  571. package/skills/risk-compliance/fraud-analysis/references/archetypes/third-party-fraud.md +27 -0
  572. package/skills/risk-compliance/fraud-analysis/references/contexts/bank-transfer.md +24 -0
  573. package/skills/risk-compliance/fraud-analysis/references/contexts/card-payment.md +30 -0
  574. package/skills/risk-compliance/fraud-analysis/references/contexts/payment-collection.md +20 -0
  575. package/skills/risk-compliance/fraud-analysis/references/contexts/payout.md +20 -0
  576. package/skills/risk-compliance/fraud-analysis/references/feature-engineering.md +158 -0
  577. package/skills/risk-compliance/fraud-analysis/references/mechanisms/account-takeover.md +36 -0
  578. package/skills/risk-compliance/fraud-analysis/references/report-rationale.md +45 -0
  579. package/skills/risk-compliance/fraud-analysis/references/report-template.md +190 -0
  580. package/skills/risk-compliance/fraud-analysis/references/review-checklist.md +175 -0
  581. package/skills/risk-compliance/fraud-analysis/references/taxonomy.md +79 -0
  582. package/skills/risk-compliance/fraud-analysis/references/terminology.md +108 -0
  583. package/skills/risk-compliance/fraud-analysis/references/workflow.md +175 -0
  584. package/skills/risk-compliance/fraud-analysis/release-check.mjs +93 -0
  585. package/skills/risk-compliance/payment-analysis/LICENSE +3 -0
  586. package/skills/risk-compliance/payment-analysis/SKILL.md +180 -0
  587. package/skills/risk-compliance/payment-analysis/references/auth-rate-actions.md +30 -0
  588. package/skills/risk-compliance/payment-analysis/references/chargebacks.md +208 -0
  589. package/skills/risk-compliance/payment-analysis/references/chinese-polish.md +51 -0
  590. package/skills/risk-compliance/payment-analysis/references/event-layers.md +127 -0
  591. package/skills/risk-compliance/payment-analysis/references/fx.md +59 -0
  592. package/skills/risk-compliance/payment-analysis/references/journey.md +79 -0
  593. package/skills/risk-compliance/payment-analysis/references/metrics.md +67 -0
  594. package/skills/risk-compliance/payment-analysis/references/report-template.md +119 -0
  595. package/skills/risk-compliance/payment-analysis/references/terminology.md +95 -0
  596. package/skills/risk-compliance/payment-analysis/references/visualization.md +56 -0
  597. package/skills/risk-compliance/payment-analysis/release-check.mjs +93 -0
  598. package/skills/risk-compliance/report-writing/LICENSE +3 -0
  599. package/skills/risk-compliance/report-writing/SKILL.md +220 -0
  600. package/skills/risk-compliance/report-writing/references/audit-report-template.md +121 -0
  601. package/skills/risk-compliance/report-writing/references/external-assessment-template.md +167 -0
  602. package/skills/risk-compliance/report-writing/references/management-report-template.md +145 -0
  603. package/skills/risk-compliance/report-writing/references/vars-report-template.md +224 -0
  604. package/skills/risk-compliance/report-writing/release-check.mjs +93 -0
  605. package/skills/risk-compliance/similar-domain/LICENSE +3 -0
  606. package/skills/risk-compliance/similar-domain/SKILL.md +203 -0
  607. package/skills/risk-compliance/similar-domain/references/entities.md +67 -0
  608. package/skills/risk-compliance/similar-domain/references/fingerprints.md +134 -0
  609. package/skills/risk-compliance/similar-domain/references/pivots.md +82 -0
  610. package/skills/risk-compliance/similar-domain/references/report-template.md +93 -0
  611. package/skills/risk-compliance/similar-domain/references/scoring.md +130 -0
  612. package/skills/risk-compliance/similar-domain/references/terminology.md +41 -0
  613. package/skills/risk-compliance/similar-domain/references/workflow.md +85 -0
  614. package/skills/risk-compliance/similar-domain/release-check.mjs +93 -0
  615. package/skills/risk-compliance/tld-detection/LICENSE +3 -0
  616. package/skills/risk-compliance/tld-detection/SKILL.md +245 -0
  617. package/skills/risk-compliance/tld-detection/agents/openai.yaml +9 -0
  618. package/skills/risk-compliance/tld-detection/references/chinese-polish.md +55 -0
  619. package/skills/risk-compliance/tld-detection/references/clean.md +51 -0
  620. package/skills/risk-compliance/tld-detection/references/clustering.md +235 -0
  621. package/skills/risk-compliance/tld-detection/references/decision.md +189 -0
  622. package/skills/risk-compliance/tld-detection/references/fx-conversion.md +232 -0
  623. package/skills/risk-compliance/tld-detection/references/report-template.md +272 -0
  624. package/skills/risk-compliance/tld-detection/references/streams.md +141 -0
  625. package/skills/risk-compliance/tld-detection/references/terminology.md +95 -0
  626. package/skills/risk-compliance/tld-detection/references/workflow.md +95 -0
  627. package/skills/risk-compliance/tld-detection/release-check.mjs +93 -0
  628. package/skills/risk-compliance/tld-detection/scripts/detect_ladders.py +390 -0
  629. package/skills/risk-compliance/tld-detection/scripts/detect_ladders.test.mjs +14 -0
  630. package/skills/risk-compliance/tld-detection/scripts/detect_streams.py +650 -0
  631. package/skills/risk-compliance/tld-detection/scripts/detect_streams.test.mjs +14 -0
  632. package/skills/risk-compliance/tld-detection/tests/test_detect_ladders.py +134 -0
  633. package/skills/risk-compliance/tld-detection/tests/test_detect_streams.py +520 -0
@@ -0,0 +1,108 @@
1
+ # Terminology and plain language
2
+
3
+ Use fixed terms consistently in business reports. Selected profile packs may add
4
+ domain terms but must not replace common metric definitions. Read this file
5
+ before writing. After writing, run the proofread in `SKILL.md` step 8.
6
+
7
+ ## Analysis terms
8
+
9
+ | English | Chinese | Do not write |
10
+ |---|---|---|
11
+ | archetype | 欺诈类型 / 分析类型 | |
12
+ | mechanism | 作案机制 | |
13
+ | context | 业务场景 | |
14
+ | customer consent | 客户真实授权 / 客户同意 | 用技术认证代替真实授权 |
15
+ | technical authentication | 技术认证 | 当成持卡人同意的证据 |
16
+ | label | 标签 | |
17
+ | label provenance | 标签来源 | |
18
+ | positive class | 正样本 | 正例 |
19
+ | negative class | 负样本 | |
20
+ | unlabeled | 未标注样本 | |
21
+ | proxy label | 近似标签 | 代理标签 |
22
+ | confirmed outcome | 已确认结果 | |
23
+ | base rate | 正样本基线率 | |
24
+ | occurrence | 触发率 | |
25
+ | precision | 精准率 | 精确率(作指标名时) |
26
+ | recall | 召回率 | |
27
+ | lift | 首次写「相对基线倍数(lift)」 | 只写英文且从不解释 |
28
+ | train set | 训练集 | |
29
+ | holdout | 留出集(holdout) | 与「验证集」来回换;正文首次后可简称留出集 |
30
+ | zero-variance | 零方差字段 | |
31
+ | condition | 条件 | 谓词(对业务读者) |
32
+ | outcome maturity | 标签成熟度 | |
33
+ | attribution confidence | 归因置信度 | |
34
+ | attempt | 授权尝试 | |
35
+ | auth rate | 授权成功率 | 转化率;3DS 转化(指授权成功率时) |
36
+ | hard decline | 硬性拒绝(hard decline) | hard 拦截(指拒绝类型时) |
37
+ | chargeback | 拒付(chargeback) | 与结算混用;退单(仅银联语境);正文首次后可简称拒付 |
38
+ | insufficient funds | 余额不足 | 余额 |
39
+ | clerical | 文书错误 | 文书 |
40
+ | quality | 质量争议 | 质量 |
41
+ | weak identity | 弱身份线索 | 弱身份键;永久黑箱 |
42
+ | point-in-time | 截至授权时点 | 不经解释的 point-in-time |
43
+ | headline metrics | 主指标 | 不经解释的 headline |
44
+ | before / after (strategy) | 策略前 / 策略后 | after 分母(单独出现) |
45
+ | false hit on good traffic | 误伤 | |
46
+
47
+ Keep proper nouns: Visa Debit, MasterCard Prepaid, D102, BIN, IIN, PAN, MID,
48
+ MCC, Worldpay, Pazien, Order ID, 3DS, Timestamp.
49
+
50
+ ## Archetypes
51
+
52
+ | ID | English | Chinese guidance |
53
+ |---|---|---|
54
+ | `third-party-fraud` | Third-party fraud | 第三方欺诈;客户未真实授权 |
55
+ | `first-party-fraud` | First-party fraud | 第一方欺诈;客户本人实施或知情参与 |
56
+ | `authorized-payment-scam` | Authorized payment scam | 授权付款诈骗;客户受骗后真实授权 |
57
+ | `unclassified` | Unclassified | 待归因;不强行归类 |
58
+ | `app-scam` | APP scam | 授权推送付款诈骗,仅用于 push payment |
59
+ | `account-takeover` | Account takeover (ATO) | 账户接管;机制,不是独立欺诈类型 |
60
+
61
+ Avoid `first-party scam`: it confuses knowing participation with victim
62
+ deception. Do not translate technical authentication as proof of customer
63
+ consent.
64
+
65
+ ## Actions
66
+
67
+ Use only actions that exist in the selected context:
68
+
69
+ | English | Chinese |
70
+ |---|---|
71
+ | block / reject | 拦截 / 拒绝 |
72
+ | require 3DS | 要求 3DS |
73
+ | reauthenticate | 要求重新认证 |
74
+ | warn / confirm | 风险提示 / 要求确认 |
75
+ | manual review | 人工审核 |
76
+ | delay / cooling-off | 延迟处理 / 冷静期 |
77
+ | hold | 暂缓 / 冻结处理(按实际政策) |
78
+ | restrict account | 限制账户(按实际政策) |
79
+ | monitor | 仅监控 |
80
+
81
+ Do not use `冻结` casually when the implemented action is only a review hold.
82
+ State policy or legal dependencies for severe actions.
83
+
84
+ ## Presentation contract
85
+
86
+ - No Markdown `**bold**` or `__bold__` in report body.
87
+ - Metrics use occurrence → precision → recall.
88
+ - Strategy coverage pairs count/rate and amount/share; money has currency.
89
+ - AND joins co-required conditions; `+` joins package components.
90
+ - Headings and tables provide structure; avoid agent/process language.
91
+ - Keep reviewer verdict, model, and repair logs out of the report.
92
+ - Prefer 留出集 after the first gloss `留出集(holdout)`. Do not bounce
93
+ between 验证集 and holdout in the same report unless quoting a column name.
94
+
95
+ ## Banned strings (grep after writing)
96
+
97
+ Chinese: `正例`, `代理标签`, `精确率`, `转化率`, `3DS 转化`, `弱身份键`,
98
+ `永久黑箱`, `方案侧证据`, `偏热`, `变冷`, `赋能`, `抓手`, `闭环`
99
+
100
+ English leftovers in Chinese reports: `headline`, `uplift` without a Chinese
101
+ gloss, `after 分母`, `hard 拦截` (when meaning decline class), `point-in-time`
102
+ without 截至授权时点.
103
+
104
+ ## Proofread
105
+
106
+ 1. Apply this glossary to headings, tables, and body.
107
+ 2. Grep the report for banned strings.
108
+ 3. Fix language only. Do not change numbers, BIN lists, thresholds, or paths.
@@ -0,0 +1,175 @@
1
+ # Fraud-analysis workflow (steps 0–9)
2
+
3
+ Called from [SKILL.md](../SKILL.md). Paths below are relative to the skill root.
4
+
5
+ ## 0 — Pre-flight
6
+
7
+ Inspect the input, requested target, and label provenance before planning a
8
+ supervised analysis. Record:
9
+
10
+ ```yaml
11
+ label_provenance: file-column | user-defined | absent
12
+ positive_definition: ""
13
+ negative_definition: ""
14
+ unlabeled_definition: ""
15
+ preflight_status: pass | needs-user-input | descriptive-only | blocked
16
+ ```
17
+
18
+ - Confirm the file is readable and identify its row grain, candidate time field,
19
+ outcome/label fields, and requested positive definition.
20
+ - When the positive label comes from an existing row-level outcome column, map
21
+ its positive value(s). Assume the rest of the mature analysis population is
22
+ negative, except explicit missing, pending, unknown, or unlabeled states.
23
+ State this assumption and show the observed values to the user when ambiguous.
24
+ - When the user defines the positive label as a condition or derived rule,
25
+ require the user to define the negative condition during pre-flight. Do not
26
+ infer `NOT positive` as negative. Ask one focused clarification and set status
27
+ to `needs-user-input` until answered.
28
+ - Rows matching neither class, both classes, explicit unknown states, or an
29
+ immature outcome window are unlabeled.
30
+ - If no usable positive and negative definitions exist, offer descriptive
31
+ segmentation without precision/recall, or block supervised analysis.
32
+
33
+ Do not proceed to the supervised workflow until pre-flight passes. A
34
+ `descriptive-only` analysis may select a profile and explore segments, but it
35
+ must not compute precision, recall, lift, or supervised strategy performance.
36
+ Profile clarification may be grouped into the same user question when both
37
+ label and attribution inputs are missing.
38
+
39
+ ## 1 — Select analysis profile
40
+
41
+ Read [taxonomy.md](taxonomy.md). Record:
42
+
43
+ ```yaml
44
+ archetype: third-party-fraud | first-party-fraud | authorized-payment-scam | unclassified
45
+ customer_role: victim | perpetrator | knowing-participant | facilitator | unknown
46
+ customer_consent: present | absent | disputed | unknown
47
+ technical_authentication: passed | failed | not-applicable | unknown
48
+ mechanisms: []
49
+ contexts: []
50
+ subtype: null
51
+ attribution_confidence: confirmed | probable | proxy | unknown
52
+ event_grain: ""
53
+ decision_point: ""
54
+ ```
55
+
56
+ - Select exactly one primary archetype. Select one or more mechanisms and
57
+ contexts when the data supports them.
58
+ - Customer consent and technical authentication are separate facts. Passed
59
+ login, MFA, or session checks do not prove genuine-customer consent.
60
+ - `APP scam` is a subtype of `authorized-payment-scam` in a `bank-transfer`
61
+ context; it is not a synonym for first-party fraud.
62
+ - If victimization versus knowing participation is unresolved, use
63
+ `unclassified`. Do not silently force attribution.
64
+ - If multiple archetypes are confirmed, run separate labels, rules, metrics,
65
+ and impact sections. Never blend them into one positive class.
66
+
67
+ Read the selected archetype, mechanism, and context references before Step 2.
68
+
69
+ ## 2 — Formalize label
70
+
71
+ - One primary label per archetype analysis. Confirmed outcomes are ground truth;
72
+ proxies must be identified as proxies.
73
+ - Carry forward the pre-flight provenance and class definitions; do not discover
74
+ the negative class here.
75
+ - Validate the pre-flight mapping against observed rows and record the resulting
76
+ positive, negative, and unlabeled counts.
77
+ - If the mapping is incomplete or contradictory, return to pre-flight with
78
+ `needs-user-input`; do not ask for or invent a negative class in this step.
79
+ - Derive labels only from supplied data and documented business meaning. Positive
80
+ and negative conditions must be disjoint. Rows matching neither, both, or an
81
+ immature/pending state are unlabeled and excluded from supervised metrics.
82
+ - Record positive definition/count, negative definition/count, unlabeled
83
+ definition/count, base rate among labeled rows, maturity window, exclusions,
84
+ and attribution confidence.
85
+ - Exclude the label, synonyms, investigations, recalls, disputes, or other later
86
+ outcomes from features when unavailable at the selected decision point.
87
+ - For delayed outcomes, ensure enough observation time or mark recent rows as
88
+ immature rather than negative.
89
+ - Do not continue to precision, recall, or supervised rule scoring until both
90
+ positive and negative classes are defined.
91
+
92
+ ## 3 — Freeze temporal validation
93
+
94
+ - Freeze the cut before feature work. Train is earlier; holdout is later.
95
+ - Do not random-shuffle rows or use random k-fold as headline validation.
96
+ - History and graph snapshots contain prior events only.
97
+ - No time column means full-sample descriptive analysis; mark metrics
98
+ **unvalidated**.
99
+
100
+ ## 4 — Engineer candidates
101
+
102
+ Read [feature-engineering.md](feature-engineering.md) and all selected
103
+ profile packs.
104
+
105
+ - Declare event grain and decision point before assessing columns.
106
+ - Classify fields as allowed now, excluded for zero variance, excluded for
107
+ timing, excluded for leakage, or context-only.
108
+ - Build thresholds, rate lists, graph lists, and watchlists on train only.
109
+ - Prefer interpretable conditions with explicit units and windows.
110
+ - Do not invent columns, identity links, consent, intent, or actor attribution.
111
+
112
+ ## 5 — Select shortlist
113
+
114
+ Use train only: lift, support, stability, operability, and meaningful
115
+ interactions. Keep tiny or attribution-uncertain spikes for monitoring.
116
+
117
+ ## 6 — Score rules
118
+
119
+ State explicit conditions, event grain, units, windows, and decision point.
120
+ Headline holdout metrics use this order:
121
+
122
+ **occurrence → precision → recall**
123
+
124
+ Train metrics are debugging evidence only. If outcomes are value-bearing, also
125
+ measure captured positive amount without replacing count-based metrics.
126
+
127
+ ## 7 — Map actions and packages
128
+
129
+ Use actions from the selected context packs; there is no universal 3DS action.
130
+
131
+ | Metric and evidence profile | Shared guidance |
132
+ |---|---|
133
+ | High precision, stable, severe impact | Consider the context's strongest preventive action |
134
+ | Higher recall, moderate precision | Add verification, review, warning, hold, or friction |
135
+ | Weak, unstable, small-N, uncertain attribution | Monitor or investigate |
136
+
137
+ - Legal, regulatory, policy, and operational authority constrain account holds,
138
+ freezes, rejects, beneficiary blocks, and reporting.
139
+ - Keep individual rules separate from multi-rule **strategy packages**.
140
+ - Freeze default and comparison packages before report writing.
141
+ - For each package compute triggered count/rate and amount/share, then precision
142
+ and recall, plus the context-specific customer, operations, conversion, delay,
143
+ and loss measures required by its pack.
144
+
145
+ ## 8 — Write business report
146
+
147
+ Read [report-template.md](report-template.md),
148
+ [terminology.md](terminology.md), and selected profile packs.
149
+
150
+ Use reader order:
151
+
152
+ 执行摘要 → 抽样、分析画像与标签 → 规则发现 → 策略整体影响 → 特征 → 附录
153
+
154
+ - Include the analysis profile and actor attribution near the start.
155
+ - Report only domain-appropriate actions, denominators, and impact KPIs.
156
+ - Strategy impact always includes count/rate and amount/share, then precision
157
+ and recall. Add only the selected contexts' required impact measures.
158
+ - Do not present scenario estimates or proxy-label value as measured loss saved.
159
+ - Save to a path such as `reports/fraud-analysis/<scope>.md`.
160
+ - Before finishing: grep the report for banned strings in
161
+ [terminology.md](terminology.md) and fix language only (not numbers,
162
+ BIN lists, or thresholds).
163
+
164
+ ## 9 — Independent review
165
+
166
+ Read [review-checklist.md](review-checklist.md) and selected packs.
167
+
168
+ - Review the common method and presentation contract.
169
+ - Apply checks from every selected archetype, mechanism, and context pack.
170
+ - Auto-fix mechanical issues only. Do not silently change attribution, label,
171
+ customer role, or action severity.
172
+ - Prefer a fresh independent reviewer. If unavailable, use a fresh same-session
173
+ checklist and disclose that only in the chat delivery note.
174
+ - Deliver the business report plus a short note with verdict, fixes, and open
175
+ judgment issues. Keep review process details out of the report.
@@ -0,0 +1,93 @@
1
+ #!/usr/bin/env node
2
+ import { spawnSync } from 'node:child_process';
3
+ import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
4
+ import { homedir } from 'node:os';
5
+ import { dirname, join } from 'node:path';
6
+ import { fileURLToPath } from 'node:url';
7
+
8
+ const DAY_MS = 24 * 60 * 60 * 1000;
9
+ const WEEK_MS = 7 * DAY_MS;
10
+ const here = dirname(fileURLToPath(import.meta.url));
11
+
12
+ function readJson(path, fallback = {}) {
13
+ try { return JSON.parse(readFileSync(path, 'utf8')); } catch { return fallback; }
14
+ }
15
+
16
+ function frontmatterValue(text, key) {
17
+ const frontmatter = /^---\n([\s\S]*?)\n---/.exec(text)?.[1] ?? '';
18
+ const match = new RegExp('^' + key + ':\\s*([^\\n]+)$', 'm').exec(frontmatter);
19
+ return match?.[1].trim().replace(/^['"]|['"]$/g, '') ?? null;
20
+ }
21
+
22
+ function repositoryOf(source) {
23
+ const value = String(source ?? '').trim();
24
+ const match = /^(?:git@github\.com:|https:\/\/github\.com\/)?([A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+?)(?:\.git)?$/.exec(value);
25
+ return match?.[1] ?? null;
26
+ }
27
+
28
+ function stableVersion(value) {
29
+ const match = /^v?(\d+)\.(\d+)\.(\d+)$/.exec(String(value ?? '').trim());
30
+ return match ? match.slice(1).map(Number) : null;
31
+ }
32
+
33
+ function newer(left, right) {
34
+ for (let index = 0; index < 3; index += 1) {
35
+ if (left[index] !== right[index]) return left[index] > right[index];
36
+ }
37
+ return false;
38
+ }
39
+
40
+ function writeCache(path, value) {
41
+ try {
42
+ mkdirSync(dirname(path), { recursive: true });
43
+ writeFileSync(path, JSON.stringify(value));
44
+ } catch { /* A read-only cache must not block skill use. */ }
45
+ }
46
+
47
+ function main(now = Date.now()) {
48
+ if (process.env.ONEABOVEIO_NO_UPDATE_CHECK) return;
49
+ const skill = readFileSync(join(here, 'SKILL.md'), 'utf8');
50
+ const name = frontmatterValue(skill, 'name');
51
+ const localVersion = stableVersion(frontmatterValue(skill, 'release-version'));
52
+ if (!name || !localVersion) return;
53
+
54
+ const lock = readJson(join(process.env.HOME || homedir(), '.agents', '.skill-lock.json'));
55
+ const entry = lock.skills?.[name];
56
+ const repository = repositoryOf(entry?.sourceUrl || entry?.source);
57
+ if (!repository) return;
58
+
59
+ const cacheRoot = process.env.XDG_CACHE_HOME || join(process.env.HOME || homedir(), '.cache');
60
+ const cachePath = join(cacheRoot, '1aboveio-skills', 'release-check.json');
61
+ const all = readJson(cachePath);
62
+ const cache = all[repository] && typeof all[repository] === 'object' ? all[repository] : {};
63
+
64
+ if (!cache.lastCheck || now - cache.lastCheck >= DAY_MS) {
65
+ const result = spawnSync('gh', ['api', 'repos/' + repository + '/releases/latest', '--jq', '.tag_name'], {
66
+ encoding: 'utf8',
67
+ stdio: ['ignore', 'pipe', 'ignore'],
68
+ timeout: 1500,
69
+ });
70
+ cache.lastCheck = now;
71
+ if (result.status === 0 && stableVersion(result.stdout)) cache.latestTag = result.stdout.trim();
72
+ else delete cache.latestTag;
73
+ all[repository] = cache;
74
+ writeCache(cachePath, all);
75
+ }
76
+
77
+ const latestVersion = stableVersion(cache.latestTag);
78
+ if (!latestVersion || !newer(latestVersion, localVersion)) return;
79
+ if (cache.notifiedTag === cache.latestTag && cache.notifiedAt && now - cache.notifiedAt < WEEK_MS) return;
80
+
81
+ cache.notifiedTag = cache.latestTag;
82
+ cache.notifiedAt = now;
83
+ all[repository] = cache;
84
+ writeCache(cachePath, all);
85
+ const command = `npx skills@1.5.23 add '${repository}#${cache.latestTag}' --global --agent universal claude-code --skill ${name} --yes`;
86
+ process.stdout.write(
87
+ `UPDATE_AVAILABLE: A newer 1AboveIO skills release (${cache.latestTag}) is available; this skill is `
88
+ + `v${localVersion.join('.')}. Ask once whether to refresh ${name}. On approval run \`${command}\`. `
89
+ + 'The refreshed instructions apply next session. Either way, continue the current task and do not ask again this session.\n',
90
+ );
91
+ }
92
+
93
+ try { main(); } catch { /* Update checks are advisory and always fail silent. */ }
@@ -0,0 +1,3 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 1AboveIO
@@ -0,0 +1,180 @@
1
+ ---
2
+ name: payment-analysis
3
+ description: >
4
+ Produce a visualized payment overview from authorization + settlement
5
+ extracts (optional chargebacks): executive summary, top statistics, payment
6
+ journey Sankey, and topics (volume, weekly trend, auth rate, BIN-country
7
+ contribution, decline-by-reason, decline-by-country). Amounts report in USD
8
+ (Forex Service daily conversion). Chargebacks separate normal and
9
+ pre-dispute cases; Visa pre-disputes are excluded from VAMP-style metrics
10
+ and calculated separately, while Mastercard 拒付率 is lagged. 运营影响 is
11
+ 3DS / 风控拦截 / soft-decline retry only. Use whenever the user asks for payment overview, auth-rate analysis,
12
+ decline mix, BIN/issuer-country contribution, settlement GMV, payment journey,
13
+ Sankey funnel, FX-to-USD, chargeback rate, 运营影响, or "business analysis of
14
+ transactions" — even if they do not say payment-analysis. Do NOT use for
15
+ supervised fraud-rule mining (fraud-analysis) or TLD / MCC-miscoding
16
+ clusters (tld-detection).
17
+ release-version: 0.36.0
18
+ ---
19
+ **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
20
+ # Payment Analysis
21
+
22
+ Descriptive payment-funnel analytics with charts. Explains what happened in the
23
+ book. Does not invent fraud rules or claim loss saved.
24
+
25
+ Use authorization **and** settlement when both files exist. Chargebacks are
26
+ optional topic fuel, not required for the journey core.
27
+
28
+ | Layer | Typical file | Row grain |
29
+ |---|---|---|
30
+ | Authorizations | `Authorizations_*.csv` | one auth attempt |
31
+ | Settlements | `Sales-and-refunds_*settlements*.csv` | one sale or refund |
32
+ | Chargebacks | `Chargebacks_*.csv` | one dispute (optional) |
33
+
34
+ **Produce:** Markdown + preferred Chinese/bilingual HTML under
35
+ `reports/payment-analysis/`.
36
+ **Do not produce:** supervised precision/recall packages (`fraud-analysis`) or TLD clusters (`tld-detection`).
37
+
38
+ Read the playbook for the step you are on. Paths under `references/` are
39
+ relative to this skill.
40
+
41
+ ## Workflow
42
+
43
+ Follow these steps in order.
44
+
45
+ ### 0 — Pre-flight
46
+
47
+ Read [event-layers.md](references/event-layers.md). Record layers present and
48
+ missing, paths, time fields, currencies, and which journey checkpoints have
49
+ usable columns. Amount reporting is USD: read [fx.md](references/fx.md) before
50
+ any amount KPI (all-USD books still write `金额均为 USD` and do not call Forex).
51
+
52
+ Decide the three report periods after reading the extracts and before any
53
+ calculation. Ask once, in one question that shows all three defaults; skip any
54
+ period the user already gave. In a run where no one can answer (batch,
55
+ subagent), do not ask: use the defaults and mark them `default` in the report
56
+ header. `M` is the month containing the main period's end date, or the user's
57
+ explicit report month.
58
+
59
+ | Period | Covers | Default |
60
+ |---|---|---|
61
+ | Main | top stats, Sankey, 4.1, 4.3–4.7 snapshots, 运营影响 | this month to date (MTD) |
62
+ | Trend | 4.2 and every week-over-week / month-over-month chart or finding | last 6 months, `M-5`–`M` |
63
+ | Fraud & chargeback | 4.8 and every fraud-over-time chart (疑似欺诈 declines by month) | last 12 months, `M-11`–`M` |
64
+
65
+ Day-level lines, decline/fraud mix tables, and 运营影响 triggers use the main
66
+ period. Only charts whose x-axis is weeks or months use the trend or fraud &
67
+ chargeback period. If the extracts have no rows in the execution month, the
68
+ main default becomes the latest calendar month with data; say why.
69
+
70
+ Example: run on 2026-10-19 with data through 10-19 and no stated period → main
71
+ 2026-10-01–10-19 (MTD), trend 2026-05–2026-10, fraud & chargeback
72
+ 2025-11–2026-10. The shared cutoff and edge cases:
73
+ [event-layers.md](references/event-layers.md) Window selection.
74
+
75
+ ### 1 — Segments
76
+
77
+ Segment by BIN country, card product, response message/code, settlement type
78
+ when present. Section 4.8 uses the fraud & chargeback period regardless of the
79
+ main period's day/week/month range. Read
80
+ [chargebacks.md](references/chargebacks.md) for historical inputs, cutoffs,
81
+ deduplication, and missing-month handling.
82
+
83
+ ### 2 — KPIs
84
+
85
+ Compute auth + settlement metrics from [metrics.md](references/metrics.md).
86
+ Convert non-USD amounts per [fx.md](references/fx.md) before any sum or share.
87
+ If chargebacks are present, monthly 拒付率 follows
88
+ [chargebacks.md](references/chargebacks.md) (Visa same-month, Mastercard lagged,
89
+ Visa pre-disputes excluded from the normal/VAMP-style numerator and calculated
90
+ separately, skip empty brand-months, no blended Visa+Mastercard ratio).
91
+ Compute trend series over the trend period and section 4.8 over the fraud &
92
+ chargeback period, not just the main period. Preserve every month label and
93
+ coverage row even when history is missing; missing ratio points are gaps, not
94
+ zeros.
95
+
96
+ ### 3 — Journey Sankey
97
+
98
+ Build **count** flows with [journey.md](references/journey.md). Join sales to
99
+ approved auths on `Order ID`. Footnote unjoined refunds. Skip risk/3DS nodes
100
+ when authentication fields are empty; caption the skips.
101
+
102
+ ### 4 — Write outputs
103
+
104
+ Structure and chapter minima:
105
+ [report-template.md](references/report-template.md). Chart marks:
106
+ [visualization.md](references/visualization.md). English/Chinese terms:
107
+ [terminology.md](references/terminology.md). 运营影响 only from
108
+ [auth-rate-actions.md](references/auth-rate-actions.md) when the extract
109
+ supports the trigger.
110
+
111
+ ```text
112
+ reports/payment-analysis/<scope>_overview.md
113
+ reports/payment-analysis/<scope>_overview.zh.md
114
+ reports/payment-analysis/<scope>_overview.zh.html
115
+ ```
116
+
117
+ HTML is preferred when there are charts. Glossary applies to headings, KPI
118
+ labels, legends, and Sankey skip chips.
119
+
120
+ ### 5 — Language proofread
121
+
122
+ Grep every report file for the banned strings in
123
+ [terminology.md](references/terminology.md). Replace hits using that table.
124
+ Do not change numbers, joins, or chart data.
125
+
126
+ ### 6 — Sanity check
127
+
128
+ - [ ] Main, trend, and fraud & chargeback periods and the cutoff are stated in the report header
129
+ - [ ] Trend charts span the trend period; fraud/chargeback charts span their period
130
+ - [ ] Structure is summary → top stats → Sankey → topics → 运营影响
131
+ - [ ] Auth + settlement both used when both files exist
132
+ - [ ] Sankey skips unavailable risk/3DS checkpoints and says so
133
+ - [ ] Count/amount are bars; rate is a line; dual axes when combined
134
+ - [ ] Amount axes/legends include currency (`授权尝试金额 USD`, …)
135
+ - [ ] No supervised fraud-rule metrics
136
+ - [ ] Non-USD amounts converted per fx.md; all-USD books say 金额均为 USD
137
+ - [ ] Normal chargebacks, pre-disputes, and unclassified cases are distinct
138
+ - [ ] Visa pre-disputes are excluded from VAMP-style metrics and calculated separately
139
+ - [ ] Chargeback monthly rates skip empty brand-months; no blended Visa+MC ratio
140
+ - [ ] Section 4.8 shows every month of the fraud & chargeback period, missing/partial coverage disclosed; Mastercard's earliest month uses the preceding month's sales (N+1 sale months, default 13)
141
+ - [ ] 运营影响 only from auth-rate-actions.md when triggered
142
+ - [ ] Language matches terminology.md; banned strings have no unexplained hits
143
+
144
+ ### 7 — Editorial review and Chinese polish (required)
145
+
146
+ After the sanity check, run `editorial-review` (`{editorial-review baseDir}/SKILL.md`)
147
+ on the report's narrative source, naming
148
+ [report-template.md](references/report-template.md) as its template, then rerun the
149
+ sanity check. Then run `polish-cn` (`{polish-cn baseDir}/SKILL.md`) on the Chinese
150
+ prose with the blocks, protected terms and guardrails in
151
+ [chinese-polish.md](references/chinese-polish.md). Record the model that ran and any fallback in the run record, not the report's
152
+ data-source footer. Only language may change in the polish. Re-render every
153
+ Chinese artifact from the polished source and rerun the glossary and
154
+ fact-preservation checks before delivery.
155
+
156
+ ## Boundary with fraud-analysis and tld-detection
157
+
158
+ | Need | Skill |
159
+ |---|---|
160
+ | Volume, journey Sankey, auth rate, decline mix, settlement overview, 运营影响 routing | `payment-analysis` |
161
+ | Proxy/confirmed fraud labels, holdout precision/recall, 3DS/block **packages** | `fraud-analysis` |
162
+ | Potential TLD clusters, currency-amount-pair ladders, MCC miscoding, stuffing | `tld-detection` |
163
+
164
+ Routing 3DS / 风控拦截 / retry from this extract is not a fraud-analysis rule
165
+ package.
166
+
167
+ ## Reference index
168
+
169
+ | Need | Read |
170
+ |---|---|
171
+ | Grains, joins, windows | [event-layers.md](references/event-layers.md) |
172
+ | USD conversion | [fx.md](references/fx.md) |
173
+ | KPI formulas | [metrics.md](references/metrics.md) |
174
+ | Visa / Mastercard 拒付率 | [chargebacks.md](references/chargebacks.md) |
175
+ | Sankey checkpoints | [journey.md](references/journey.md) |
176
+ | Chart marks | [visualization.md](references/visualization.md) |
177
+ | Report chapters | [report-template.md](references/report-template.md) |
178
+ | 运营影响 | [auth-rate-actions.md](references/auth-rate-actions.md) |
179
+ | Language / banned strings | [terminology.md](references/terminology.md) |
180
+ | Editorial review, Chinese polish guardrails | [chinese-polish.md](references/chinese-polish.md) |
@@ -0,0 +1,30 @@
1
+ # Actions that often lift auth rate
2
+
3
+ Use this list when writing **运营影响**. Pick only items the extract
4
+ supports. Do not dump the whole list. These are routing / retry operations,
5
+ not a `fraud-analysis` rule package (no precision/recall, no “loss saved”).
6
+
7
+ Auth rate = 授权成功 / 授权尝试. BIN country = 发卡行国家.
8
+
9
+ | # | When the data shows | Action | Do not write |
10
+ |---|---|---|---|
11
+ | 1 | BIN countries under SCA (e.g. UK, Spain, Italy) and Authentication method is empty / None | Route **3DS** for those 发卡行国家 | 强客户认证 as the standing term (use SCA); claiming 3DS will raise conversion |
12
+ | 2 | A country (or book) where 疑似欺诈 is a large share of 授权拒绝 | **风控拦截** and/or **3DS** on that 发卡行国家 | Calling 疑似欺诈 “confirmed fraud”; putting this in the 3DS 与风控 exec slot as a decline mix |
13
+ | 3 | Material **软性拒绝** (issuer soft: 余额不足, Do not honor, 超限, …) | **Retry** the authorization (same or later attempt, per acquirer retry rules) | Treating 无效卡 / 账户关闭 as retry-eligible |
14
+ | 4 | 余额不足, 安全码无效, 有效期无效, Do not honor 等可解释的拒绝 | On the **payment page**, show the matching reason (余额不足 / 安全码错误 / 有效期错误), not a generic “支付失败” | Inventing copy the issuer did not return; hiding the reason |
15
+
16
+ ## How to cite in the report
17
+
18
+ One short 运营影响 bullet per action, with the evidence already in the
19
+ report (country, share, 软性拒绝 count). Example shapes:
20
+
21
+ - SCA:英国、西班牙、意大利受 SCA 约束,当前分析时段内无 3DS,建议对这些发卡行国家路由 3DS。
22
+ - 疑似欺诈:某国疑似欺诈占授权拒绝 X%,建议风控拦截或 3DS。
23
+ - 软性拒绝:软性拒绝 N 笔(余额不足 / Do not honor / …),可按收单行规则重试。
24
+ - 支付页提示:余额不足、安全码无效、有效期无效应在支付页给出对应提示,便于用户换卡或改卡号、有效期、安全码。
25
+
26
+ ## Out of scope
27
+
28
+ - Supervised thresholds, holdout, 3DS/block “packages” → `fraud-analysis`
29
+ - Inventing retry counts or expected auth-rate lift
30
+ - Mixing portfolio and merchant grains in one file