SeanJ1ang/onechange-controlled-ux-research

SeanJ1ang-Profil

Letzte erfasste Quellaktivität: 25. August 2026 um 15:04

SkillsMP-Katalog aktualisiert: 17. Oktober 2026 um 00:09

gesammelte Skills: 1

GitHub-Stars: 0
GitHub-Forks: 0

README des Repositorys

README-Quelldatei: README.md

README-Quelldatei lesen

Vollständige README anzeigen

# OneChange | 只改一处 [![复用包验证](https://github.com/SeanJ1ang/onechange-controlled-ux-research/actions/workflows/validate-reuse.yml/badge.svg)](https://github.com/SeanJ1ang/onechange-controlled-ux-research/actions/workflows/validate-reuse.yml) [![MIT License](https://img.shields.io/badge/license-MIT-2ea44f.svg)](LICENSE) [![Agent Skill](https://img.shields.io/badge/Agent%20Skill-onechange--causal--ux-2563eb.svg)](skills/README.md) [English](README_EN.md) · [打开线上应用](https://dcniaqwtmoca.feishuapp.com/app/app_17ck5tdp98h) · [下载 Starter Kit](https://github.com/SeanJ1ang/onechange-controlled-ux-research/releases/download/starter-kit-v1.0.0/onechange-starter-kit.zip) · [复制飞书 Base Starter](https://larkcommunity.feishu.cn/base/Vq2lbiVlHapvemsTjQhcpAEVnIV) 候选新版同时改了标题、按钮、文案和模块时，普通 A/B 对比无法解释结果到底由哪一处变化造成。OneChange 会先识别混杂，再把一个变化写成变量契约，编译出只改这一处的 B*，最后发布首击和 5 秒研究，把证据回收到飞书。当前演示聚焦一个具体问题：把游客结账入口从文字链接改成实心按钮，是否更容易被找到和理解？ ## 从这里开始 | 你的目标 | 最短路径 | 预计时间 | | --- | --- | --- | | 先体验完整产品 | 打开[线上应用](https://dcniaqwtmoca.feishuapp.com/app/app_17ck5tdp98h)，加载合成演示 | 3 分钟 | | 用自己的 A/B 问题试跑方法 | 下载 [Starter Kit](https://github.com/SeanJ1ang/onechange-controlled-ux-research/releases/download/starter-kit-v1.0.0/onechange-starter-kit.zip)，修改研究简报并把 Prompt 交给 Agent | 5 至 10 分钟 | | 在飞书里建立决策台 | 复制[零数据 Base Starter](https://larkcommunity.feishu.cn/base/Vq2lbiVlHapvemsTjQhcpAEVnIV) | 5 分钟 | | 让 Codex 长期复用这套方法 | 安装 `$onechange-causal-ux` | 2 分钟 | | 自托管完整产品 | 克隆仓库，按[复用与部署指南](docs/REUSE_GUIDE.md)接入自己的妙搭环境 | 约 30 分钟起 | ### 可以直接这样说 ```text 使用 $onechange-causal-ux，检查这两版界面同时改了什么，只冻结一个可测试变量，为首击或 5 秒研究生成 Research Pack，并明确哪些结论目前还不能下。 ``` 如果不想安装 Skill，解压 Starter Kit 后复制其中的 `PROMPT.md` 也能完成第一次试跑。 ## 它怎样完成一项研究 ```text A/B 截图 → AI 提取可观察差异与混杂 → 研究者确认唯一变量 → 妙搭从冻结基线编译 A 与 B* → 完整性门禁检查目标区外变化 → 发布首击与 5 秒任务 → 分离 Preview 和正式样本 → 形成统计结论并回写飞书 Base → PM 保留最终业务决策 ``` 这条流程刻意把三类判断分开： - AI 判断截图里观察到了什么，但不宣布哪个版本更好。 - 统计模块判断现有行为证据有多强，但不自动代替产品经理做业务裁决。 - 产品经理结合业务、成本与研究边界，在飞书决策台记录最终决定。 ## 飞书和 AI 各自做什么 | 环节 | AI | 飞书妙搭与 Base | | --- | --- | --- | | 识别 | 从拼接截图提取结构化差异、证据和警告 | 承载官方图片结构化能力，保存分析记录 | | 约束 | 推荐可测试的目标差异 | 保存研究者确认的唯一变量、冻结字段和 DOM ROI | | 编译 | 不自由重画页面 | 从同一基线生成 A/B*，目标区外有变化就阻断发布 | | 研究 | 不替参与者作答 | 随机分配正式版本，记录匿名首击、耗时和 5 秒回答 | | 决策 | 不伪造行为结果 | 计算效应量、区间、p 值与 SRM，把决策包写回 Base | 飞书不是结果粘贴板。妙搭运行时、应用数据库、匿名 Runner、AI 能力调用和 Base 回写都在核心链路中。 ## 直接复用 ### 1. Starter Kit [下载 `onechange-starter-kit.zip`](https://github.com/SeanJ1ang/onechange-controlled-ux-research/releases/download/starter-kit-v1.0.0/onechange-starter-kit.zip) 后，只需要： 1. 在 `RESEARCH_BRIEF.json` 中替换业务背景、可观察差异和决策问题。 2. 把 `PROMPT.md` 连同简报交给 Codex 或其他支持文件读取的 Agent。 3. 用包内校验器检查生成的研究包： ```bash node validate_research_pack.cjs my-study.onechange.json --fix-hash node validate_research_pack.cjs my-study.onechange.json ``` Starter Kit 自带研究简报、可复制 Prompt、发布检查表、示例 Research Pack、JSON Schema、SHA-256 校验器、文件清单和 MIT License。它不含实验 ID、发布令牌、参与者数据或比赛生产记录。仓库维护者可运行 `npm run build:starter` 重新组装同一套材料；生成清单会记录每个交付文件的 SHA-256，避免发布包与 Skill 内的规范悄悄漂移。 ### 2. Agent Skill 需要 Node.js 18 或更高版本： ```bash npx skills add SeanJ1ang/onechange-controlled-ux-research --list npx skills add SeanJ1ang/onechange-controlled-ux-research \ --global --agent codex --skill onechange-causal-ux --yes --copy ``` 验证和更新： ```bash npx skills list --global --agent codex --json npx skills update onechange-causal-ux --global --yes ``` 安装时应保留完整的 `skills/onechange-causal-ux/` 目录。除了 `SKILL.md`，运行还会用到研究契约、schema、示例、资产和校验脚本。完整说明见 [Skill 目录](skills/README.md)。 ### 3. 飞书 Base Starter [公开 UX 决策台 Starter](https://larkcommunity.feishu.cn/base/Vq2lbiVlHapvemsTjQhcpAEVnIV) 是零数据、零密钥的结构模板。复制后按[飞书 Native 闭环说明](docs/FEISHU_NATIVE.md)配置自己的 OpenAPI 和 Workflow。它不会连接比赛生产库。 ## 证据边界 OneChange 把以下内容明确分开： - 合成基准用于验证流程，不是参与者研究。 - AI smoke 用于证明能力链可运行，不是模型准确率评测。 - Preview 用于验收 Runner，不进入正式推断。 - Research Pack 校验只证明格式和 payload 完整，不证明研究方法一定正确。 - 当前公开项目不声称真实转化提升、统计显著或某个设计已经获胜。具体的生产验收事实、当前样本状态、已运行命令和已知限制记录在[证据与限制](docs/EVIDENCE_STATUS.md)，避免把审计日志塞进第一次阅读路径。 ## 运行完整应用完整应用需要 Node.js 22、npm 10、已初始化的妙搭 full-stack 应用、`ux-screen-diff` capability，以及按顺序执行的数据库迁移 `0001` 至 `0007`。 ```bash npm install npm run check:reuse npm run check:docs npm run test:reuse npm run type:check npm run test:onechange -- --runInBand npm run build:prod ``` 本地环境、AI capability、数据库迁移和生产发布步骤见[复用与部署指南](docs/REUSE_GUIDE.md)。不要把 `.env.local`、凭证、Runner token、参与者数据或带签名的临时图片 URL 提交到仓库。 ## 文档 - [产品介绍与比赛期间新增能力](docs/PRODUCT_BRIEF.md) - [用户上手指南](docs/USER_GUIDE.md) - [Starter Kit 源材料](starter-kit/README.md) - [研究模板与 Research Pack](templates/README.md) - [Agent Skill 与第一次试跑](skills/README.md) - [证据状态、限制与验证记录](docs/EVIDENCE_STATUS.md) - [3 分钟 Demo 脚本](docs/DEMO_SCRIPT.md) - [投稿表单草稿](docs/SUBMISSION_FORM.md) - [贡献规范](CONTRIBUTING.md) - [English overview](README_EN.md) ## 开源边界本仓库使用 [MIT License](LICENSE)。公开 GitHub 是经过敏感信息检查的稳定快照，提交消息会记录对应的妙搭源提交。Research Pack 只迁移研究设计，不迁移实验身份、参与者事件、历史结论或发布令牌。

README des Repositorys wird geladen…

Skills in diesem Repository

Klassifizierung ausstehend

Skill

Beruf

Beschreibung

Aktualisiert

onechange-causal-ux

nicht klassifiziert

Turn competing A/B interface drafts into a controlled single-variable UX research plan and a validated OneChange Research Pack. Use when a PM or UX researcher needs to identify confounds, freeze one testable change, plan first-click or five-second research,…

Quellsprache: Englisch

2026-08-25

Es werden 1 von 1 gesammelten Skills angezeigt.

Mit einem KI-Assistenten installieren

Diesen Prompt kopieren und in den verwendeten KI-Assistenten einfügen.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/SeanJ1ang/onechange-controlled-ux-research.