@umacloud/knowledge 1.0.1

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 (418) hide show
  1. package/00-governance/governance-capabilities.md +557 -0
  2. package/00-governance/knowledge-map.md +39 -0
  3. package/00-governance/maintenance-policy.md +76 -0
  4. package/00-governance/review-checklist.md +81 -0
  5. package/README.md +13 -0
  6. package/ai/01-standards/agent-development-complete.md +691 -0
  7. package/ai/01-standards/llm-application-complete.md +488 -0
  8. package/ai/01-standards/mlops-complete.md +798 -0
  9. package/ai/01-standards/prompt-engineering-complete.md +646 -0
  10. package/ai/01-standards/rag-architecture-complete.md +649 -0
  11. package/ai/02-playbooks/llm-evaluation-playbook.md +847 -0
  12. package/ai/03-checklists/ai-project-checklist.md +215 -0
  13. package/ai/04-antipatterns/ai-antipatterns.md +661 -0
  14. package/ai/05-cases/case-rag-production.md +147 -0
  15. package/ai/06-glossary/ai-glossary.md +162 -0
  16. package/ai/agent-evaluation-benchmark.md +53 -0
  17. package/ai/ai-agent-memory-context-management.md +41 -0
  18. package/ai/ai-cost-capacity-optimization-playbook.md +42 -0
  19. package/ai/ai-data-security-and-compliance-playbook.md +37 -0
  20. package/ai/ai-domain-index-and-checklist.md +40 -0
  21. package/ai/ai-governance-maturity-model.md +50 -0
  22. package/ai/ai-model-selection-and-routing-strategy.md +47 -0
  23. package/ai/ai-observability-and-oncall-runbook.md +52 -0
  24. package/ai/ai-rag-engineering-playbook.md +42 -0
  25. package/ai/ai-red-team-and-safety-evaluation.md +42 -0
  26. package/ai/ai-release-readiness-and-rollback-gate.md +42 -0
  27. package/ai/llm-agent-engineering-deep-dive.md +57 -0
  28. package/ai/prompt-and-tool-guardrails.md +52 -0
  29. package/api/01-standards/enterprise-api-standards.md +198 -0
  30. package/api/01-standards/rest-api-design-guide.md +63 -0
  31. package/api/02-playbooks/api-pagination-playbook.md +93 -0
  32. package/api/02-playbooks/graphql-production-playbook.md +176 -0
  33. package/api/03-checklists/api-review-checklist.md +55 -0
  34. package/api/04-antipatterns/api-antipatterns.md +112 -0
  35. package/architecture/01-standards/api-gateway-patterns.md +496 -0
  36. package/architecture/01-standards/cloud-native-patterns.md +644 -0
  37. package/architecture/01-standards/distributed-systems-patterns.md +591 -0
  38. package/architecture/01-standards/event-driven-architecture.md +595 -0
  39. package/architecture/01-standards/microservices-patterns-complete.md +968 -0
  40. package/architecture/01-standards/microservices-patterns.md +495 -0
  41. package/architecture/01-standards/system-design-interview.md +664 -0
  42. package/architecture/02-playbooks/microservices-patterns-playbook.md +137 -0
  43. package/architecture/02-playbooks/migration-playbook.md +780 -0
  44. package/architecture/02-playbooks/system-design-playbook.md +779 -0
  45. package/architecture/03-checklists/architecture-decision-checklist.md +297 -0
  46. package/architecture/04-antipatterns/architecture-antipatterns.md +417 -0
  47. package/architecture/05-cases/case-netflix-microservices.md +413 -0
  48. package/architecture/06-glossary/architecture-glossary.md +164 -0
  49. package/architecture/adr-template-and-examples.md +38 -0
  50. package/architecture/api-gateway-deep-dive.md +1291 -0
  51. package/architecture/configuration-management.md +1162 -0
  52. package/architecture/distributed-transactions.md +1220 -0
  53. package/architecture/microservices-complete.md +735 -0
  54. package/architecture/resilience-and-disaster-patterns.md +37 -0
  55. package/architecture/service-governance.md +1198 -0
  56. package/architecture/system-architecture-deep-dive.md +37 -0
  57. package/backend/01-standards/analytics-and-growth.md +65 -0
  58. package/backend/01-standards/api-and-error-conventions.md +120 -0
  59. package/backend/01-standards/application-layering-and-packaging.md +160 -0
  60. package/backend/01-standards/auth-implementation.md +104 -0
  61. package/backend/01-standards/backend-framework-idioms.md +74 -0
  62. package/backend/01-standards/background-jobs-and-async.md +66 -0
  63. package/backend/01-standards/caching-strategies-complete.md +390 -0
  64. package/backend/01-standards/config-and-observability.md +77 -0
  65. package/backend/01-standards/data-modeling-and-persistence.md +94 -0
  66. package/backend/01-standards/django-complete.md +1765 -0
  67. package/backend/01-standards/email-and-notifications.md +64 -0
  68. package/backend/01-standards/fastapi-complete.md +925 -0
  69. package/backend/01-standards/file-upload-and-storage.md +66 -0
  70. package/backend/01-standards/graphql-api-complete.md +416 -0
  71. package/backend/01-standards/llm-application-standard.md +78 -0
  72. package/backend/01-standards/message-queue-patterns.md +379 -0
  73. package/backend/01-standards/microservices-and-distributed.md +78 -0
  74. package/backend/01-standards/nestjs-complete.md +2167 -0
  75. package/backend/01-standards/payment-integration.md +80 -0
  76. package/backend/01-standards/rate-limiting-complete.md +451 -0
  77. package/backend/01-standards/realtime-and-websocket.md +65 -0
  78. package/backend/01-standards/search-and-filtering.md +64 -0
  79. package/backend/01-standards/spring-boot-complete.md +445 -0
  80. package/backend/02-playbooks/api-design-playbook.md +718 -0
  81. package/backend/02-playbooks/email-send-playbook.md +130 -0
  82. package/backend/02-playbooks/file-upload-s3-playbook.md +153 -0
  83. package/backend/02-playbooks/typescript-enterprise-playbook.md +133 -0
  84. package/backend/02-playbooks/websocket-realtime-playbook.md +154 -0
  85. package/backend/03-checklists/api-launch-checklist.md +189 -0
  86. package/backend/04-antipatterns/backend-antipatterns.md +1051 -0
  87. package/blockchain/01-standards/blockchain-basics.md +557 -0
  88. package/blockchain/01-standards/smart-contract-development.md +1315 -0
  89. package/cicd/01-standards/deployment-and-delivery-standard.md +96 -0
  90. package/cicd/01-standards/github-actions-complete.md +473 -0
  91. package/cicd/01-standards/release-and-store-submission.md +75 -0
  92. package/cicd/02-playbooks/cicd-pipeline-playbook.md +144 -0
  93. package/cicd/02-playbooks/release-management-playbook.md +605 -0
  94. package/cicd/03-checklists/pipeline-security-checklist.md +168 -0
  95. package/cicd/04-antipatterns/cicd-antipatterns.md +589 -0
  96. package/cicd/05-cases/case-deployment-automation.md +221 -0
  97. package/cicd/05-cases/case-gitops-transformation.md +212 -0
  98. package/cicd/06-glossary/cicd-glossary.md +114 -0
  99. package/cicd/cicd-blueprint-deep-dive.md +38 -0
  100. package/cicd/release-readiness-gate.md +37 -0
  101. package/cloud-native/01-standards/container-security.md +741 -0
  102. package/cloud-native/01-standards/kubernetes-complete.md +812 -0
  103. package/cloud-native/02-playbooks/api-gateway-playbook.md +155 -0
  104. package/cloud-native/02-playbooks/gitops-with-argocd.md +760 -0
  105. package/cloud-native/02-playbooks/k8s-troubleshooting-playbook.md +1942 -0
  106. package/cloud-native/02-playbooks/message-queue-playbook.md +129 -0
  107. package/cloud-native/02-playbooks/multicloud-governance.md +726 -0
  108. package/cloud-native/02-playbooks/serverless-patterns.md +788 -0
  109. package/cloud-native/02-playbooks/service-mesh-playbook.md +612 -0
  110. package/cloud-native/02-playbooks/terraform-iac-playbook.md +143 -0
  111. package/cloud-native/03-checklists/container-security-checklist.md +431 -0
  112. package/cloud-native/03-checklists/k8s-production-readiness-checklist.md +460 -0
  113. package/cloud-native/04-antipatterns/container-antipatterns.md +660 -0
  114. package/cloud-native/04-antipatterns/k8s-antipatterns.md +743 -0
  115. package/cloud-native/05-cases/case-k8s-migration.md +478 -0
  116. package/cloud-native/05-cases/case-k8s-scaling.md +642 -0
  117. package/cloud-native/05-cases/case-k8s-security-incident.md +397 -0
  118. package/cloud-native/06-glossary/cloud-native-glossary.md +337 -0
  119. package/cross-platform/01-standards/cross-platform-frameworks.md +83 -0
  120. package/cross-platform/01-standards/platform-selection-and-architecture.md +77 -0
  121. package/data/01-standards/elasticsearch-complete.md +2098 -0
  122. package/data/01-standards/postgresql-complete.md +1613 -0
  123. package/data/01-standards/redis-complete.md +1527 -0
  124. package/data/02-playbooks/database-optimization-playbook.md +403 -0
  125. package/data/02-playbooks/elasticsearch-production-playbook.md +132 -0
  126. package/data/03-checklists/database-launch-checklist.md +187 -0
  127. package/data/04-antipatterns/database-antipatterns.md +873 -0
  128. package/data/05-cases/case-database-migration.md +310 -0
  129. package/data/06-glossary/database-glossary.md +440 -0
  130. package/data/data-governance-and-modeling-deep-dive.md +39 -0
  131. package/data-engineering/01-standards/airflow-complete.md +523 -0
  132. package/data-engineering/01-standards/kafka-complete.md +1521 -0
  133. package/data-engineering/02-playbooks/spark-etl-playbook.md +496 -0
  134. package/data-engineering/03-checklists/pipeline-launch-checklist.md +194 -0
  135. package/data-engineering/04-antipatterns/data-pipeline-antipatterns.md +684 -0
  136. package/data-engineering/05-cases/case-real-time-pipeline.md +355 -0
  137. package/data-engineering/06-glossary/data-engineering-glossary.md +429 -0
  138. package/database/01-standards/database-schema-standards.md +147 -0
  139. package/database/02-playbooks/postgresql-optimization-quick.md +52 -0
  140. package/database/02-playbooks/postgresql-performance-optimization.md +58 -0
  141. package/database/02-playbooks/postgresql-production-playbook.md +146 -0
  142. package/database/02-playbooks/redis-caching-playbook.md +117 -0
  143. package/database/03-checklists/database-review-checklist.md +50 -0
  144. package/database/04-antipatterns/database-antipatterns.md +112 -0
  145. package/design/01-standards/ui-design-system-complete.md +423 -0
  146. package/design/02-playbooks/design-handoff-playbook.md +254 -0
  147. package/design/02-playbooks/design-review-playbook.md +388 -0
  148. package/design/03-checklists/design-review-checklist.md +246 -0
  149. package/design/04-antipatterns/design-antipatterns.md +378 -0
  150. package/design/05-cases/case-design-system-adoption.md +328 -0
  151. package/design/06-glossary/design-glossary.md +329 -0
  152. package/design/ui-full-lifecycle-cross-platform-playbook.md +571 -0
  153. package/design/ux-system-deep-dive.md +38 -0
  154. package/design-systems/00-craft-rules.md +71 -0
  155. package/design-systems/aesthetic-families.md +43 -0
  156. package/design-systems/anti-ai-slop.md +162 -0
  157. package/design-systems/bold-geometric.md +120 -0
  158. package/design-systems/brutalist-bold.md +103 -0
  159. package/design-systems/editorial-clean.md +109 -0
  160. package/design-systems/glass-aurora.md +108 -0
  161. package/design-systems/modern-minimal.md +145 -0
  162. package/design-systems/premium-luxury.md +106 -0
  163. package/design-systems/product-type-design-map.md +48 -0
  164. package/design-systems/soft-warm.md +123 -0
  165. package/design-systems/tech-utility.md +113 -0
  166. package/desktop/01-standards/desktop-app-standard.md +72 -0
  167. package/desktop/01-standards/desktop-design.md +71 -0
  168. package/development/00-governance/document-template.md +41 -0
  169. package/development/01-standards/api-versioning-strategies.md +432 -0
  170. package/development/01-standards/authentication-patterns-complete.md +479 -0
  171. package/development/01-standards/css-architecture-complete.md +550 -0
  172. package/development/01-standards/database-migration-strategies.md +484 -0
  173. package/development/01-standards/elasticsearch-complete.md +347 -0
  174. package/development/01-standards/git-complete.md +371 -0
  175. package/development/01-standards/golang-complete.md +1565 -0
  176. package/development/01-standards/graphql-complete.md +298 -0
  177. package/development/01-standards/javascript-bundlers-complete.md +469 -0
  178. package/development/01-standards/javascript-typescript-complete.md +528 -0
  179. package/development/01-standards/jest-complete.md +275 -0
  180. package/development/01-standards/linux-complete.md +234 -0
  181. package/development/01-standards/logging-observability-complete.md +526 -0
  182. package/development/01-standards/microservices-communication.md +502 -0
  183. package/development/01-standards/mongodb-complete.md +406 -0
  184. package/development/01-standards/oauth2-complete.md +285 -0
  185. package/development/01-standards/performance-optimization-complete.md +289 -0
  186. package/development/01-standards/playwright-complete.md +247 -0
  187. package/development/01-standards/postgresql-complete.md +456 -0
  188. package/development/01-standards/pytest-complete.md +340 -0
  189. package/development/01-standards/python-async-programming.md +902 -0
  190. package/development/01-standards/python-complete.md +956 -0
  191. package/development/01-standards/python-decorators-complete.md +799 -0
  192. package/development/01-standards/python-design-patterns.md +2854 -0
  193. package/development/01-standards/python-packaging-distribution.md +420 -0
  194. package/development/01-standards/python-testing-strategies.md +607 -0
  195. package/development/01-standards/python-web-frameworks-comparison.md +471 -0
  196. package/development/01-standards/redis-complete.md +317 -0
  197. package/development/01-standards/rest-api-complete.md +316 -0
  198. package/development/01-standards/rust-complete.md +578 -0
  199. package/development/01-standards/typescript-advanced-types.md +1513 -0
  200. package/development/01-standards/web-security-complete.md +292 -0
  201. package/development/02-playbooks/api-design-playbook.md +810 -0
  202. package/development/02-playbooks/database-migration-playbook.md +580 -0
  203. package/development/02-playbooks/debugging-playbook.md +692 -0
  204. package/development/02-playbooks/feature-delivery-playbook.md +430 -0
  205. package/development/02-playbooks/incident-hotfix-playbook.md +387 -0
  206. package/development/02-playbooks/performance-optimization-playbook.md +531 -0
  207. package/development/02-playbooks/performance-tuning-playbook.md +652 -0
  208. package/development/02-playbooks/refactor-playbook.md +403 -0
  209. package/development/02-playbooks/release-playbook.md +469 -0
  210. package/development/03-checklists/architecture-review-checklist.md +168 -0
  211. package/development/03-checklists/data-migration-checklist.md +157 -0
  212. package/development/03-checklists/oncall-handover-checklist.md +173 -0
  213. package/development/03-checklists/pr-checklist.md +158 -0
  214. package/development/03-checklists/production-readiness-checklist.md +190 -0
  215. package/development/03-checklists/release-readiness-checklist.md +154 -0
  216. package/development/03-checklists/security-review-checklist.md +182 -0
  217. package/development/04-antipatterns/api-antipatterns.md +657 -0
  218. package/development/04-antipatterns/architecture-antipatterns.md +686 -0
  219. package/development/04-antipatterns/backend-antipatterns.md +648 -0
  220. package/development/04-antipatterns/cicd-antipatterns.md +540 -0
  221. package/development/04-antipatterns/code-smell-antipatterns.md +571 -0
  222. package/development/04-antipatterns/data-antipatterns.md +658 -0
  223. package/development/04-antipatterns/database-antipatterns.md +578 -0
  224. package/development/04-antipatterns/frontend-antipatterns.md +635 -0
  225. package/development/04-antipatterns/reliability-antipatterns.md +700 -0
  226. package/development/04-antipatterns/security-antipatterns.md +747 -0
  227. package/development/05-cases/case-api-version-migration.md +428 -0
  228. package/development/05-cases/case-authorization-hardening.md +383 -0
  229. package/development/05-cases/case-bluegreen-rollback.md +466 -0
  230. package/development/05-cases/case-cache-snowball-protection.md +485 -0
  231. package/development/05-cases/case-ci-cd-pipeline.md +544 -0
  232. package/development/05-cases/case-database-scaling.md +500 -0
  233. package/development/05-cases/case-db-hotspot-optimization.md +487 -0
  234. package/development/05-cases/case-incident-mttr-reduction.md +563 -0
  235. package/development/05-cases/case-microservice-migration.md +375 -0
  236. package/development/05-cases/case-performance-optimization.md +406 -0
  237. package/development/05-cases/case-security-incident-response.md +345 -0
  238. package/development/06-glossary/full-stack-glossary.md +166 -0
  239. package/development/09-maturity/quarterly-audit-template.md +35 -0
  240. package/development/11-ui-excellence/ui-aesthetic-system.md +41 -0
  241. package/development/11-ui-excellence/ui-engineering-excellence.md +435 -0
  242. package/development/12-scenarios/development-scenarios-guide.md +565 -0
  243. package/development/13-implementation-assets/implementation-toolkit.md +282 -0
  244. package/development/13-implementation-assets/knowledge-gates-execution.md +43 -0
  245. package/development/14-full-lifecycle/software-lifecycle-gates.md +511 -0
  246. package/development/15-lifecycle-templates/project-templates-collection.md +791 -0
  247. package/development/api-contract-and-versioning-guide.md +36 -0
  248. package/development/api-governance-complete.md +43 -0
  249. package/development/backend-engineering-complete.md +43 -0
  250. package/development/code-review-quality-complete.md +43 -0
  251. package/development/concurrency-reliability-complete.md +43 -0
  252. package/development/database-engineering-complete.md +43 -0
  253. package/development/engineering-effectiveness-complete.md +43 -0
  254. package/development/engineering-standards-deep-dive.md +38 -0
  255. package/development/frontend-engineering-complete.md +43 -0
  256. package/development/performance-capacity-complete.md +43 -0
  257. package/development/refactor-migration-complete.md +42 -0
  258. package/development/refactoring-and-techdebt-playbook.md +37 -0
  259. package/development/security-in-development-complete.md +43 -0
  260. package/devops/01-standards/cicd-pipeline-complete.md +262 -0
  261. package/devops/01-standards/docker-complete.md +1490 -0
  262. package/devops/01-standards/github-actions-complete.md +337 -0
  263. package/devops/01-standards/kubernetes-complete.md +638 -0
  264. package/devops/01-standards/terraform-complete.md +2117 -0
  265. package/devops/02-playbooks/docker-compose-playbook.md +233 -0
  266. package/devops/02-playbooks/docker-k8s-production-playbook.md +186 -0
  267. package/devops/02-playbooks/docker-production-playbook.md +952 -0
  268. package/edge-iot/01-standards/edge-iot-complete.md +473 -0
  269. package/experts/architect/api-design.md +178 -0
  270. package/experts/architect/methodology.md +124 -0
  271. package/experts/architect/security.md +75 -0
  272. package/experts/backend-lead/methodology.md +216 -0
  273. package/experts/devops/methodology.md +160 -0
  274. package/experts/frontend-lead/methodology.md +178 -0
  275. package/experts/product-manager/industry/ecommerce.md +43 -0
  276. package/experts/product-manager/industry/saas.md +40 -0
  277. package/experts/product-manager/methodology.md +97 -0
  278. package/experts/qa-lead/methodology.md +123 -0
  279. package/experts/qa-lead/test-strategy.md +128 -0
  280. package/experts/uiux-designer/methodology.md +125 -0
  281. package/frontend/01-standards/accessibility-complete.md +532 -0
  282. package/frontend/01-standards/accessibility-standard.md +74 -0
  283. package/frontend/01-standards/admin-dashboard-and-crud.md +72 -0
  284. package/frontend/01-standards/design-tokens-complete.md +444 -0
  285. package/frontend/01-standards/forms-and-validation.md +77 -0
  286. package/frontend/01-standards/frontend-architecture-and-layering.md +119 -0
  287. package/frontend/01-standards/i18n-and-localization.md +65 -0
  288. package/frontend/01-standards/nextjs-complete.md +451 -0
  289. package/frontend/01-standards/react-complete.md +713 -0
  290. package/frontend/01-standards/react-hooks-complete-guide.md +1100 -0
  291. package/frontend/01-standards/react-hooks-complete.md +1171 -0
  292. package/frontend/01-standards/seo-and-web-vitals.md +77 -0
  293. package/frontend/01-standards/state-management-complete.md +444 -0
  294. package/frontend/01-standards/vue-complete.md +499 -0
  295. package/frontend/01-standards/vue3-complete.md +2002 -0
  296. package/frontend/01-standards/web-framework-best-practices.md +64 -0
  297. package/frontend/01-standards/web-performance-complete.md +495 -0
  298. package/frontend/02-playbooks/accessibility-a11y-playbook.md +161 -0
  299. package/frontend/02-playbooks/frontend-performance-playbook.md +707 -0
  300. package/frontend/02-playbooks/i18n-internationalization-playbook.md +120 -0
  301. package/frontend/02-playbooks/performance-optimization-playbook.md +163 -0
  302. package/frontend/02-playbooks/react-nextjs-production-playbook.md +167 -0
  303. package/frontend/02-playbooks/react-state-management-playbook.md +173 -0
  304. package/frontend/03-checklists/component-quality-checklist.md +166 -0
  305. package/frontend/03-checklists/frontend-launch-checklist.md +299 -0
  306. package/frontend/04-antipatterns/frontend-antipatterns.md +886 -0
  307. package/frontend/05-cases/case-performance-optimization.md +274 -0
  308. package/harmony/01-standards/harmonyos-arkts-standard.md +75 -0
  309. package/harmony/01-standards/harmonyos-design.md +65 -0
  310. package/high-quality-engineering-playbook.md +54 -0
  311. package/incident/01-standards/incident-response-complete.md +303 -0
  312. package/incident/02-playbooks/chaos-engineering-playbook.md +883 -0
  313. package/incident/02-playbooks/postmortem-playbook.md +398 -0
  314. package/incident/03-checklists/incident-readiness-checklist.md +181 -0
  315. package/incident/04-antipatterns/incident-antipatterns.md +490 -0
  316. package/incident/05-cases/case-cascade-failure.md +176 -0
  317. package/incident/06-glossary/incident-glossary.md +114 -0
  318. package/incident/postmortem-and-response-deep-dive.md +39 -0
  319. package/industries/ecommerce/ecommerce-complete.md +631 -0
  320. package/industries/education/education-complete.md +555 -0
  321. package/industries/fintech/fintech-complete.md +501 -0
  322. package/industries/gaming/gaming-complete.md +587 -0
  323. package/industries/healthcare/healthcare-complete.md +452 -0
  324. package/low-code/01-standards/low-code-complete.md +944 -0
  325. package/miniprogram/01-standards/ai-common-mistakes.md +61 -0
  326. package/miniprogram/01-standards/miniprogram-custom-navbar-capsule.md +77 -0
  327. package/miniprogram/01-standards/miniprogram-design.md +61 -0
  328. package/miniprogram/01-standards/miniprogram-standard.md +81 -0
  329. package/mobile/01-standards/android-material-design.md +70 -0
  330. package/mobile/01-standards/flutter-complete.md +384 -0
  331. package/mobile/01-standards/ios-design-hig.md +78 -0
  332. package/mobile/01-standards/mobile-app-standard.md +85 -0
  333. package/mobile/01-standards/react-native-complete.md +352 -0
  334. package/mobile/02-playbooks/mobile-cross-platform-playbook.md +175 -0
  335. package/mobile/02-playbooks/mobile-performance.md +473 -0
  336. package/mobile/03-checklists/mobile-release-checklist.md +234 -0
  337. package/mobile/04-antipatterns/mobile-antipatterns.md +798 -0
  338. package/mobile/05-cases/case-app-performance.md +500 -0
  339. package/mobile/05-cases/case-app-startup-optimization.md +218 -0
  340. package/mobile/06-glossary/mobile-glossary.md +484 -0
  341. package/observability/01-standards/observability-standards.md +103 -0
  342. package/observability/02-playbooks/prometheus-grafana-playbook.md +135 -0
  343. package/observability/02-playbooks/structured-logging-playbook.md +73 -0
  344. package/observability/03-checklists/observability-checklist.md +54 -0
  345. package/observability/04-antipatterns/observability-antipatterns.md +106 -0
  346. package/operations/01-standards/prometheus-monitoring-complete.md +1578 -0
  347. package/operations/02-playbooks/capacity-planning-playbook.md +620 -0
  348. package/operations/03-checklists/production-launch-checklist.md +365 -0
  349. package/operations/04-antipatterns/operations-antipatterns.md +664 -0
  350. package/operations/05-cases/case-sre-practices.md +581 -0
  351. package/operations/06-glossary/operations-glossary.md +120 -0
  352. package/operations/aiops-anomaly-detection.md +758 -0
  353. package/operations/capacity-planning.md +1061 -0
  354. package/operations/chaos-engineering.md +659 -0
  355. package/operations/incident-command-system.md +38 -0
  356. package/operations/observability-complete.md +442 -0
  357. package/operations/slo-sli-playbook.md +517 -0
  358. package/operations/sre-operations-deep-dive.md +39 -0
  359. package/package.json +8 -0
  360. package/performance/01-standards/performance-and-scalability.md +80 -0
  361. package/performance/01-standards/performance-standards.md +156 -0
  362. package/performance/02-playbooks/query-optimization-playbook.md +103 -0
  363. package/performance/03-checklists/performance-checklist.md +56 -0
  364. package/performance/04-antipatterns/performance-antipatterns.md +146 -0
  365. package/product/01-standards/product-management-complete.md +285 -0
  366. package/product/02-playbooks/feature-launch-playbook.md +207 -0
  367. package/product/02-playbooks/user-research-playbook.md +532 -0
  368. package/product/03-checklists/feature-launch-checklist.md +275 -0
  369. package/product/04-antipatterns/product-antipatterns.md +355 -0
  370. package/product/05-cases/case-mvp-to-scale.md +384 -0
  371. package/product/06-glossary/product-glossary.md +462 -0
  372. package/product/feature-prioritization-framework.md +40 -0
  373. package/product/kpi-and-metric-tree.md +37 -0
  374. package/product/product-discovery-and-prd-deep-dive.md +41 -0
  375. package/quantum/01-standards/quantum-complete.md +1186 -0
  376. package/security/01-standards/api-security-complete.md +511 -0
  377. package/security/01-standards/container-runtime-security.md +574 -0
  378. package/security/01-standards/data-protection-gdpr.md +543 -0
  379. package/security/01-standards/owasp-top10-complete.md +1890 -0
  380. package/security/01-standards/secure-coding-baseline.md +90 -0
  381. package/security/01-standards/supply-chain-security.md +441 -0
  382. package/security/01-standards/web-security-checklist.md +108 -0
  383. package/security/01-standards/zero-trust-architecture.md +521 -0
  384. package/security/02-playbooks/auth-sso-playbook.md +166 -0
  385. package/security/02-playbooks/incident-response-security-playbook.md +588 -0
  386. package/security/02-playbooks/owasp-api-security-playbook.md +129 -0
  387. package/security/02-playbooks/payment-integration-playbook.md +119 -0
  388. package/security/02-playbooks/penetration-testing-playbook.md +517 -0
  389. package/security/03-checklists/security-audit-checklist.md +356 -0
  390. package/security/04-antipatterns/security-coding-antipatterns.md +580 -0
  391. package/security/05-cases/case-log4shell-incident.md +537 -0
  392. package/security/05-cases/case-major-breaches.md +468 -0
  393. package/security/06-glossary/security-glossary.md +212 -0
  394. package/security/compliance-automation.md +993 -0
  395. package/security/container-security.md +680 -0
  396. package/security/devsecops-complete.md +426 -0
  397. package/security/sast-dast-sca.md +775 -0
  398. package/security/secrets-management.md +594 -0
  399. package/security/security-architecture-deep-dive.md +37 -0
  400. package/security/threat-modeling-stride-playbook.md +40 -0
  401. package/seed-templates/auth-system.md +59 -0
  402. package/seed-templates/blog-content.md +94 -0
  403. package/seed-templates/dashboard.md +89 -0
  404. package/seed-templates/docs-site.md +73 -0
  405. package/seed-templates/e-commerce.md +50 -0
  406. package/seed-templates/saas-landing.md +92 -0
  407. package/seed-templates/settings-page.md +51 -0
  408. package/testing/01-standards/test-strategy-and-layering.md +83 -0
  409. package/testing/01-standards/testing-strategy-complete.md +422 -0
  410. package/testing/01-standards/unit-testing-best-practices.md +118 -0
  411. package/testing/02-playbooks/e2e-testing-playbook.md +988 -0
  412. package/testing/02-playbooks/testing-strategy-playbook.md +126 -0
  413. package/testing/03-checklists/test-strategy-checklist.md +208 -0
  414. package/testing/04-antipatterns/testing-antipatterns.md +718 -0
  415. package/testing/05-cases/case-testing-transformation.md +300 -0
  416. package/testing/06-glossary/testing-glossary.md +110 -0
  417. package/testing/risk-based-test-matrix.md +36 -0
  418. package/testing/testing-strategy-deep-dive.md +37 -0
@@ -0,0 +1,532 @@
1
+ ---
2
+ id: user-research-playbook
3
+ title: 用户研究作战手册 (User Research Playbook)
4
+ domain: product
5
+ category: 02-playbooks
6
+ difficulty: intermediate
7
+ tags: [playbook, product, research, user, 交付物, 前置条件, 时间线, 概述]
8
+ quality_score: 70
9
+ last_updated: 2026-06-15
10
+ ---
11
+ # 用户研究作战手册 (User Research Playbook)
12
+
13
+ ## 概述
14
+
15
+ 本手册定义了用户研究的完整流程,涵盖研究计划制定、用户访谈、可用性测试、问卷调查、数据分析和洞察报告。目标是通过系统化的研究方法获取真实用户洞察,驱动产品决策,减少拍脑袋式的设计和开发。
16
+
17
+ ## 前置条件
18
+
19
+ ### 必须满足
20
+
21
+ - [ ] 已明确研究目标和核心问题(要验证什么假设 / 要回答什么问题)
22
+ - [ ] 已确定研究预算和时间范围
23
+ - [ ] 已获得团队对研究计划的认可
24
+ - [ ] 有至少一位经验丰富的研究者主导
25
+
26
+ ### 建议满足
27
+
28
+ - [ ] 有用户画像(Persona)作为招募基础
29
+ - [ ] 有竞品分析报告作为参考
30
+ - [ ] 有历史用户数据(行为数据、客服工单、NPS 反馈)
31
+ - [ ] 已建立用户研究知情同意和隐私保护流程
32
+
33
+ ---
34
+
35
+ ## 步骤一:研究计划
36
+
37
+ ### 1.1 研究计划模板
38
+
39
+ ```markdown
40
+ # 用户研究计划:[项目名称]
41
+
42
+ ## 1. 背景与目标
43
+ - 业务背景:[简述产品/功能背景和当前问题]
44
+ - 研究目标:[明确 2-3 个核心目标]
45
+ - 核心问题:
46
+ 1. [需要回答的问题 1]
47
+ 2. [需要回答的问题 2]
48
+ 3. [需要回答的问题 3]
49
+
50
+ ## 2. 研究假设
51
+ - H1: [假设 1 -- 预期用户行为/态度]
52
+ - H2: [假设 2 -- 预期用户行为/态度]
53
+ - H3: [假设 3 -- 预期用户行为/态度]
54
+
55
+ ## 3. 研究方法
56
+ | 方法 | 目的 | 参与人数 | 时长 |
57
+ |------|------|---------|------|
58
+ | 用户访谈 | 探索用户需求和痛点 | 8-12 人 | 各 45-60 分钟 |
59
+ | 可用性测试 | 验证设计方案的易用性 | 5-8 人 | 各 30-45 分钟 |
60
+ | 问卷调查 | 量化验证定性发现 | 200+ 人 | 约 10 分钟 |
61
+
62
+ ## 4. 目标用户
63
+ - 用户画像 A:[描述],招募 X 人
64
+ - 用户画像 B:[描述],招募 Y 人
65
+ - 排除标准:[不适合参与的用户类型]
66
+
67
+ ## 5. 时间线
68
+ - Week 1: 计划制定 + 招募
69
+ - Week 2: 执行访谈/测试
70
+ - Week 3: 数据分析
71
+ - Week 4: 报告产出 + 分享
72
+
73
+ ## 6. 交付物
74
+ - 研究洞察报告 (PDF/Notion)
75
+ - 关键发现卡片 (Miro/FigJam)
76
+ - 设计建议清单
77
+ - 原始数据归档
78
+ ```
79
+
80
+ ### 1.2 研究方法选择矩阵
81
+
82
+ | 场景 | 推荐方法 | 样本量 | 产出 |
83
+ |------|---------|--------|------|
84
+ | 探索新方向,不确定用户需要什么 | 深度访谈 | 8-15 人 | 用户需求和痛点地图 |
85
+ | 验证设计方案是否好用 | 可用性测试 | 5-8 人 | 问题列表和改进建议 |
86
+ | 量化已知问题的严重程度 | 问卷调查 | 200+ 人 | 统计数据和优先级排序 |
87
+ | 理解用户真实使用行为 | 行为数据分析 | 全量用户 | 漏斗转化和使用模式 |
88
+ | 对比两个设计方案 | A/B 测试 | 1000+ 人 | 统计显著性结论 |
89
+ | 了解用户日常工作/生活 | 日记研究 | 10-15 人 | 使用情境和习惯洞察 |
90
+ | 快速验证概念方向 | 概念测试 | 8-12 人 | 概念吸引力和改进方向 |
91
+
92
+ ---
93
+
94
+ ## 步骤二:用户访谈
95
+
96
+ ### 2.1 招募
97
+
98
+ #### 招募渠道
99
+
100
+ | 渠道 | 适用场景 | 时间 | 成本 |
101
+ |------|---------|------|------|
102
+ | 产品内弹窗邀请 | 活跃用户 | 3-5 天 | 低 |
103
+ | 客户成功团队推荐 | B2B 关键客户 | 5-7 天 | 低 |
104
+ | 社交媒体/社群 | 潜在用户 | 3-7 天 | 中 |
105
+ | 专业招募平台 (UserTesting / 问卷星) | 特定画像用户 | 1-3 天 | 高 |
106
+ | 线下场所拦截 | 大众消费场景 | 1-2 天 | 中 |
107
+
108
+ #### 招募筛选问卷
109
+
110
+ ```markdown
111
+ # 筛选问卷(示例:电商产品)
112
+
113
+ 1. 您的年龄段?
114
+ - [ ] 18-24 - [ ] 25-34 - [ ] 35-44 - [ ] 45-54 - [ ] 55+
115
+
116
+ 2. 您最近 3 个月在网上购物的频率?
117
+ - [ ] 每周多次 - [ ] 每周一次 - [ ] 每月 2-3 次 - [ ] 每月一次以下
118
+
119
+ 3. 您最常使用的购物平台?(多选)
120
+ - [ ] 淘宝 - [ ] 京东 - [ ] 拼多多 - [ ] 抖音商城 - [ ] 其他:___
121
+
122
+ 4. 您是否有以下经历?(筛选关键行为)
123
+ - [ ] 在购物车中放置商品后最终没买
124
+ - [ ] 因为找不到想要的商品而放弃购物
125
+ - [ ] 因为退换货流程复杂而不满
126
+
127
+ 5. 您是否愿意参加约 45 分钟的线上访谈?(补贴 ¥XXX)
128
+ - [ ] 是 - [ ] 否
129
+ ```
130
+
131
+ #### 招募注意事项
132
+ - 招募人数 = 实际需求 x 1.5(考虑爽约率 30%)
133
+ - 确认用户的可用时段和设备(线上需有稳定网络 + 摄像头)
134
+ - 签署知情同意书(包括录音录像授权、数据用途说明)
135
+ - 避免招募到"专业受试者"(经常参加各种调研的人)
136
+
137
+ ### 2.2 访谈问题设计
138
+
139
+ #### 问题设计原则
140
+
141
+ | 原则 | 正确 | 错误 |
142
+ |------|------|------|
143
+ | 开放式提问 | "请描述一下您上次网购的经历" | "您网购体验好不好?" |
144
+ | 关注行为而非观点 | "您当时做了什么?" | "您觉得这个功能有用吗?" |
145
+ | 避免引导 | "您如何看待这个流程?" | "您不觉得这个流程太复杂了吗?" |
146
+ | 追问细节 | "能详细说说为什么吗?" | 接受表面回答就跳到下一题 |
147
+ | 避免假设性问题 | "您上次退货是怎么操作的?" | "如果有一键退货您会用吗?" |
148
+
149
+ #### 访谈大纲模板(45 分钟)
150
+
151
+ ```markdown
152
+ # 访谈大纲:[主题]
153
+
154
+ ## 暖场 (5 min)
155
+ - 自我介绍,说明访谈目的和录音事宜
156
+ - "先请简单介绍一下您自己,您的职业和日常工作?"
157
+ - "您使用 [产品类别] 大约多长时间了?"
158
+
159
+ ## 背景了解 (10 min)
160
+ - "请描述一下您典型的 [使用场景],通常在什么情况下会用到?"
161
+ - "您目前使用什么工具/产品来完成 [任务]?"
162
+ - "在这个过程中,什么让您最困扰?"
163
+ - 追问:"能举个具体的例子吗?"
164
+ - 追问:"这种情况多久出现一次?"
165
+ - 追问:"您当时是怎么解决的?"
166
+
167
+ ## 核心探索 (20 min)
168
+ - "请回忆一下您最近一次 [核心行为] 的完整过程"
169
+ - 追问起始:"是什么触发了这个行为?"
170
+ - 追问过程:"中间有没有遇到什么困难?"
171
+ - 追问结果:"最终结果满意吗?"
172
+ - 追问情感:"当时的感受是什么?"
173
+
174
+ - [针对具体假设的探索问题]
175
+ - "在 [场景] 中,您通常会怎么做?"
176
+ - "您觉得 [现有方案] 最大的问题是什么?"
177
+ - "如果要改善 [问题],您觉得什么最重要?"
178
+
179
+ ## 竞品参考 (5 min)
180
+ - "您有没有用过其他类似的产品?"
181
+ - "跟 [竞品] 相比,您觉得有什么不同?"
182
+ - "其他产品有什么让您印象深刻的?"
183
+
184
+ ## 收尾 (5 min)
185
+ - "关于 [主题],还有什么是您想补充的?"
186
+ - "如果只能改变一件事来改善您的体验,您希望是什么?"
187
+ - 感谢 + 补贴发放说明
188
+ ```
189
+
190
+ ### 2.3 访谈执行
191
+
192
+ #### 执行清单
193
+
194
+ ```
195
+ 访谈前
196
+ ├── 测试录音/录像设备和网络
197
+ ├── 准备访谈大纲和记录模板
198
+ ├── 确认用户已签知情同意书
199
+ └── 安排记录员(或 AI 转录工具)
200
+
201
+ 访谈中
202
+ ├── 开场说明:目的、时长、录音、无对错之分
203
+ ├── 从简单问题开始,建立信任
204
+ ├── 保持中立表情和语气,不评价用户回答
205
+ ├── 80/20 法则:用户说 80%,研究者说 20%
206
+ ├── 记录关键引述(原话,带时间戳)
207
+ ├── 观察非语言信号(迟疑、皱眉、叹气)
208
+ └── 预留最后 5 分钟做开放式收集
209
+
210
+ 访谈后(30 分钟内)
211
+ ├── 整理访谈笔记,补充观察备忘
212
+ ├── 标记 3-5 个关键发现(印象最深的)
213
+ ├── 归档录音/录像文件
214
+ └── 更新招募和执行进度表
215
+ ```
216
+
217
+ #### 常见陷阱与应对
218
+
219
+ | 陷阱 | 表现 | 应对 |
220
+ |------|------|------|
221
+ | 用户给出期望答案 | "这个功能挺好的"(敷衍) | 追问具体使用场景和频率 |
222
+ | 用户漫谈偏题 | 花 10 分钟讲无关故事 | "非常有意思,我想回到 [主题]..." |
223
+ | 用户过于沉默 | 只回答"是/否" | 换成更具体的情境问题 |
224
+ | 用户提出解决方案 | "你们应该加个 XX 按钮" | "什么情况让您觉得需要这个功能?" |
225
+ | 研究者引导回答 | "所以您觉得这很麻烦对吧?" | 改为"您对这个过程有什么感受?" |
226
+
227
+ ---
228
+
229
+ ## 步骤三:可用性测试
230
+
231
+ ### 3.1 测试准备
232
+
233
+ ```markdown
234
+ # 可用性测试计划
235
+
236
+ ## 测试对象
237
+ - 原型/产品版本:[Figma Prototype v2.1 / 线上版本]
238
+ - 测试设备:[桌面浏览器 / 移动端 / 两者]
239
+
240
+ ## 测试任务(3-5 个核心任务)
241
+
242
+ ### 任务 1:注册并完成首次设置
243
+ - 场景描述:"您第一次使用这个产品,请完成注册并设置您的偏好"
244
+ - 成功标准:5 分钟内完成注册 + 至少设置 2 项偏好
245
+ - 观察重点:注册流程的跳出点、偏好设置的可理解性
246
+
247
+ ### 任务 2:搜索并购买一件商品
248
+ - 场景描述:"请搜索一件 200 元以内的蓝色 T 恤,并完成购买"
249
+ - 成功标准:3 分钟内找到目标商品并进入支付页
250
+ - 观察重点:搜索 + 筛选的使用路径、商品详情页的信息充分性
251
+
252
+ ### 任务 3:处理异常场景
253
+ - 场景描述:"您收到了一件尺码不合的衣服,请发起退换货"
254
+ - 成功标准:找到退换货入口并成功提交申请
255
+ - 观察重点:入口发现率、流程的清晰度
256
+
257
+ ## 数据收集
258
+ - 任务完成率(Completion Rate)
259
+ - 任务完成时间(Time on Task)
260
+ - 错误次数(Error Count)
261
+ - 任务后满意度评分(1-7 单项满意度量表)
262
+ - 出声思维法(Think Aloud)记录
263
+ ```
264
+
265
+ ### 3.2 测试执行
266
+
267
+ #### 出声思维法(Think Aloud Protocol)
268
+
269
+ 引导用户在操作过程中说出自己的想法:
270
+
271
+ ```
272
+ 引导话术:
273
+ "在接下来的操作中,请您把脑海中的想法说出来。
274
+ 比如:'我在找退货按钮,我觉得应该在订单里面...'
275
+ '这个图标我不太确定是什么意思...'
276
+ '我以为点这个会跳到...'
277
+ 这些都是非常有价值的反馈,没有对错之分。"
278
+ ```
279
+
280
+ #### 观察记录模板
281
+
282
+ ```markdown
283
+ | 时间 | 用户操作 | 用户说的 | 观察者备注 |
284
+ |------|---------|---------|-----------|
285
+ | 0:30 | 点击搜索框 | "我想搜蓝色T恤" | 直接输入,未使用分类导航 |
286
+ | 0:45 | 输入"蓝色T恤" | "结果好多啊" | 没注意到左侧筛选栏 |
287
+ | 1:10 | 向下滚动3屏 | "怎么按价格排序?" | 排序在页面顶部,用户已滚过 |
288
+ | 1:30 | 滚回顶部找排序 | (沉默,皱眉) | 排序下拉框不够明显 |
289
+ | 1:45 | 点击价格排序 | "找到了" | 花了1分钟才找到,期望30秒 |
290
+ ```
291
+
292
+ ### 3.3 可用性问题分级
293
+
294
+ | 级别 | 定义 | 影响 | 处理优先级 |
295
+ |------|------|------|-----------|
296
+ | 致命 (Critical) | 用户无法完成任务 | 用户流失 | 必须在上线前修复 |
297
+ | 严重 (Major) | 用户能完成但非常困难/需多次尝试 | 转化率下降 | 必须在当前版本修复 |
298
+ | 一般 (Minor) | 用户能完成但体验不佳/效率低 | 满意度下降 | 下个版本修复 |
299
+ | 建议 (Cosmetic) | 不影响使用但影响感受 | 品牌印象 | 排入 Backlog |
300
+
301
+ ---
302
+
303
+ ## 步骤四:问卷调查
304
+
305
+ ### 4.1 问卷设计
306
+
307
+ #### 问题类型与适用场景
308
+
309
+ | 问题类型 | 示例 | 适用场景 |
310
+ |---------|------|---------|
311
+ | 李克特量表 (1-5/1-7) | "您对购物体验的满意度?" | 态度/满意度测量 |
312
+ | NPS (0-10) | "您有多大可能推荐给朋友?" | 忠诚度/口碑倾向 |
313
+ | 单选题 | "您最常使用的支付方式?" | 偏好/行为分布 |
314
+ | 多选题 | "以下哪些功能您使用过?" | 功能使用广度 |
315
+ | 矩阵题 | "对以下功能的满意度?" | 多维度批量评价 |
316
+ | 开放题 | "您最希望改进什么?" | 定性补充(放在最后) |
317
+ | SUS (System Usability Scale) | 10 题标准量表 | 系统可用性基准评分 |
318
+
319
+ #### 问卷设计原则
320
+
321
+ ```
322
+ 1. 总时长控制在 5-10 分钟(15-25 题)
323
+ 2. 从简单客观题开始,逐步到复杂主观题
324
+ 3. 避免双重否定:✗ "您不觉得这个功能不好用吗?"
325
+ 4. 避免引导性:✗ "我们优秀的客服让您满意吗?"
326
+ 5. 选项互斥且穷尽:提供"其他"选项
327
+ 6. 敏感问题放后面,提供"不方便回答"选项
328
+ 7. 关键问题设置反向题(attention check)
329
+ 8. 必答题控制在 60% 以内,避免疲劳放弃
330
+ ```
331
+
332
+ ### 4.2 样本量参考
333
+
334
+ | 研究目的 | 最小样本量 | 建议样本量 | 备注 |
335
+ |---------|-----------|-----------|------|
336
+ | NPS 测量 | 100 | 200-400 | 需要按细分群体分析则更多 |
337
+ | 满意度调查 | 50 | 150-300 | 置信度 95%,误差 5% |
338
+ | A/B 偏好比较 | 每组 30 | 每组 100+ | 需要统计检验显著性 |
339
+ | 探索性调查 | 30 | 50-100 | 目的是发现模式,非精确测量 |
340
+
341
+ ---
342
+
343
+ ## 步骤五:数据分析
344
+
345
+ ### 5.1 定性数据分析(访谈/可用性测试)
346
+
347
+ #### 亲和图法(Affinity Diagram)
348
+
349
+ ```
350
+ Step 1: 提取原始数据点
351
+ - 遍历所有访谈笔记和录音转写
352
+ - 每个独立的观点/行为/引述 -> 一张便签
353
+ - 保留用户原话(引号标注)
354
+ - 标注来源(P1 = 第 1 位参与者)
355
+
356
+ Step 2: 自底向上分组
357
+ - 将含义相近的便签归为一组
358
+ - 为每组命名(主题标签)
359
+ - 常见分组维度:用户目标/痛点/期望/行为模式/情感反应
360
+
361
+ Step 3: 提炼洞察
362
+ - 每个主题组 -> 一个洞察陈述
363
+ - 格式:[用户类型] 在 [场景] 中感到 [痛点/需求],因为 [原因]
364
+ - 标注支撑数据量(N=X 位用户提及)
365
+
366
+ Step 4: 优先级排序
367
+ - 频率(多少用户提到)x 严重程度(对体验的影响)
368
+ - 高频 + 高严重 = 必须解决
369
+ - 高频 + 低严重 = 优化体验
370
+ - 低频 + 高严重 = 监控关注
371
+ ```
372
+
373
+ #### 洞察陈述示例
374
+
375
+ ```markdown
376
+ ### 洞察 1:新用户在注册后不知道下一步做什么 (N=7/10)
377
+
378
+ **发现**:70% 的新用户完成注册后在首页停留超过 30 秒,不知道第一步操作是什么。
379
+
380
+ **用户引述**:
381
+ - "注册完了然后呢?页面上东西太多了,不知道从哪开始" (P2)
382
+ - "我以为会有个教程之类的" (P5)
383
+ - "找了半天才发现要先创建项目" (P8)
384
+
385
+ **影响**:注册后 7 天留存率仅 15%,可能与首次体验困惑有关。
386
+
387
+ **建议**:添加新手引导(Onboarding Flow),包含 3-5 步核心操作引导。
388
+ ```
389
+
390
+ ### 5.2 定量数据分析(问卷/行为数据)
391
+
392
+ ```python
393
+ # 常用分析方法
394
+
395
+ # 1. 描述性统计
396
+ import pandas as pd
397
+
398
+ df = pd.read_csv("survey_results.csv")
399
+ print(df["satisfaction"].describe()) # 均值/中位数/标准差
400
+ print(df["satisfaction"].value_counts()) # 频率分布
401
+
402
+ # 2. NPS 计算
403
+ promoters = len(df[df["nps_score"] >= 9])
404
+ detractors = len(df[df["nps_score"] <= 6])
405
+ total = len(df)
406
+ nps = (promoters - detractors) / total * 100
407
+ print(f"NPS: {nps:.0f}")
408
+
409
+ # 3. 交叉分析
410
+ pd.crosstab(df["user_type"], df["satisfaction"], normalize="index")
411
+ # 查看不同用户类型的满意度分布差异
412
+
413
+ # 4. 统计显著性检验
414
+ from scipy import stats
415
+ group_a = df[df["variant"] == "A"]["conversion"]
416
+ group_b = df[df["variant"] == "B"]["conversion"]
417
+ t_stat, p_value = stats.ttest_ind(group_a, group_b)
418
+ print(f"p-value: {p_value:.4f}") # < 0.05 则差异显著
419
+
420
+ # 5. SUS 评分计算
421
+ # 奇数题:得分 - 1;偶数题:5 - 得分;总和 x 2.5
422
+ sus_scores = []
423
+ for _, row in df.iterrows():
424
+ odd_sum = sum(row[f"sus_{i}"] - 1 for i in [1, 3, 5, 7, 9])
425
+ even_sum = sum(5 - row[f"sus_{i}"] for i in [2, 4, 6, 8, 10])
426
+ sus_scores.append((odd_sum + even_sum) * 2.5)
427
+ print(f"SUS Average: {sum(sus_scores)/len(sus_scores):.1f}")
428
+ # SUS > 68 = 可用性高于平均; > 80 = 优秀
429
+ ```
430
+
431
+ ---
432
+
433
+ ## 步骤六:洞察报告
434
+
435
+ ### 6.1 报告结构
436
+
437
+ ```markdown
438
+ # 用户研究洞察报告:[项目名称]
439
+ 日期:YYYY-MM-DD | 研究者:[姓名]
440
+
441
+ ## 执行摘要(1 页)
442
+ - 研究背景和目标
443
+ - 方法概述(N 人访谈 + N 人可用性测试 + N 份问卷)
444
+ - 3-5 个核心发现(一句话 + 严重程度)
445
+ - 总体建议
446
+
447
+ ## 研究方法
448
+ - 研究设计和时间线
449
+ - 参与者画像分布(年龄/职业/使用频率/经验水平)
450
+ - 数据收集和分析方法
451
+
452
+ ## 核心发现
453
+
454
+ ### 发现 1:[标题] -- [严重程度]
455
+ - 数据支撑:[定量数据 + 定性证据]
456
+ - 用户引述:[2-3 条原话]
457
+ - 影响评估:[对业务/体验的影响]
458
+ - 建议方案:[具体可操作的改进建议]
459
+
460
+ ### 发现 2:...
461
+ ### 发现 3:...
462
+
463
+ ## 可用性测试结果
464
+ | 任务 | 完成率 | 平均时间 | 满意度 | 关键问题 |
465
+ |------|--------|---------|--------|---------|
466
+ | 任务 1 | 90% | 2m30s | 5.2/7 | 入口不明显 |
467
+ | 任务 2 | 60% | 4m15s | 3.8/7 | 流程步骤过多 |
468
+ | 任务 3 | 80% | 3m00s | 4.5/7 | 文案不够清晰 |
469
+
470
+ ## 问卷调查结果
471
+ - NPS: XX (Promoters XX% / Passives XX% / Detractors XX%)
472
+ - SUS: XX/100
473
+ - 满意度分布图
474
+ - 关键交叉分析结果
475
+
476
+ ## 用户旅程地图(可选)
477
+ - 阶段 -> 行为 -> 触点 -> 痛点 -> 情感曲线 -> 机会点
478
+
479
+ ## 优先级建议
480
+ | # | 建议 | 影响 | 实施难度 | 优先级 |
481
+ |---|------|------|---------|--------|
482
+ | 1 | 添加新手引导 | 高 | 中 | P0 |
483
+ | 2 | 优化搜索筛选 | 高 | 低 | P0 |
484
+ | 3 | 改进错误提示 | 中 | 低 | P1 |
485
+ | 4 | 添加个性化推荐 | 中 | 高 | P2 |
486
+
487
+ ## 附录
488
+ - 访谈大纲
489
+ - 问卷全文
490
+ - 原始数据链接(内部权限)
491
+ ```
492
+
493
+ ### 6.2 报告分享与落地
494
+
495
+ ```
496
+ 报告产出后
497
+ ├── 1. 团队分享会(30 分钟)
498
+ │ ├── 播放 2-3 段关键用户录像片段
499
+ │ ├── 展示核心发现和数据
500
+ │ └── 讨论优先级和下一步计划
501
+ ├── 2. 与设计团队对齐
502
+ │ ├── 将发现转化为设计任务
503
+ │ ├── 更新 Persona 和用户旅程地图
504
+ │ └── 输入到下一轮设计迭代
505
+ ├── 3. 与产品团队对齐
506
+ │ ├── 将建议写入产品 Backlog
507
+ │ ├── 标注优先级和预期影响
508
+ │ └── 纳入下个 Sprint 规划
509
+ ├── 4. 归档
510
+ │ ├── 研究资料归档(录音/笔记/数据)
511
+ │ ├── 洞察库更新(累积知识)
512
+ │ └── 记录研究方法的反思和改进点
513
+ └── 5. 跟踪
514
+ ├── 建议落地情况追踪
515
+ ├── 上线后数据验证(建议是否有效)
516
+ └── 输入到下一轮研究
517
+ ```
518
+
519
+ ---
520
+
521
+ ## Agent Checklist
522
+
523
+ - [ ] 研究计划已明确目标、假设、方法、时间线和交付物
524
+ - [ ] 用户招募覆盖目标画像,筛选标准明确
525
+ - [ ] 访谈问题为开放式、非引导性,关注行为而非观点
526
+ - [ ] 可用性测试任务有明确的场景描述和成功标准
527
+ - [ ] 问卷设计控制在 10 分钟内,避免引导和双重否定
528
+ - [ ] 定性数据通过亲和图法系统性分析,标注数据支撑量
529
+ - [ ] 定量数据有描述性统计和显著性检验
530
+ - [ ] 洞察报告包含数据支撑、用户引述和可操作建议
531
+ - [ ] 发现已转化为优先级排序的产品/设计任务
532
+ - [ ] 研究资料已归档,洞察库已更新