对话笔记直发：5.28 OpenSpec 速查表。分类：小程序接单。
yoshop2.0-uniapp 的 OpenSpec 速查表
先记结论
直接改，不用 OpenSpec
适合：
- 改文案
- 改颜色/间距
- 调整一个按钮样式
- 改已知跳转
- 单文件、小于 20~30 行的小改动
用 OpenSpec
适合：
- 新增一个页面入口
- 新增一个页面模块
- 增加一个筛选/交互
- 改一个小业务流程
- 涉及 2 个以上文件
- 你担心改飞
4 个命令怎么记
/opsx-explore
先想，不写代码
/opsx-propose
建这次改动的方案和任务
/opsx-apply
按方案开始改代码
/opsx-archive
做完后归档
适合你项目的推荐流程
小需求但不是特别小
最常用这套：
/opsx-propose <change-name 或需求描述>
/opsx-apply <change-name>
/opsx-archive <change-name>每个命令在你项目里的典型场景
1. /opsx-explore
什么时候用
你还没想清楚：
- 放首页还是个人中心
- 要不要改后端
- 会影响哪些页面
- 现有代码里应该挂在哪个模块上
例子
/opsx-explore 小程序首页增加联系客服入口，放在哪里更合适？/opsx-explore 商品详情页增加发货说明，会影响哪些组件和接口？适合的问题类型
- 方案选择
- 影响范围分析
- 风险预判
- 现有代码结构摸底
2. /opsx-propose
什么时候用
你已经知道要改什么，但想先把范围定住。
例子
/opsx-propose add-home-contact-entry或者直接说中文需求：
/opsx-propose 在小程序首页增加联系客服入口它适合的任务
- 首页加功能入口
- 商品详情新增说明模块
- 个人中心增加菜单项
- 订单列表加筛选
- 某个页面增加一块交互逻辑
不适合
- 单纯改样式
- 单纯改文案
- 一个很简单的小按钮且无复杂行为
3. /opsx-apply
什么时候用
你已经有 change 了，要真正开始改代码。
例子
/opsx-apply add-home-contact-entry如果当前只有一个 change，也可能直接：
/opsx-apply它适合的任务
- 已经明确实现路径
- 有 proposal/tasks
- 想按任务一步步落地
4. /opsx-archive
什么时候用
这次改动做完了，要收尾。
例子
/opsx-archive add-home-contact-entry适合
- 功能完成
- 验证通过
- 不再继续改这个 change
你的 change name 怎么取
尽量用：
- 英文
- kebab-case
- 动词开头
- 简短但明确
推荐格式
add-home-contact-entryadd-order-status-filtershow-shipping-note-on-product-detailadd-member-signin-entryimprove-home-banner-jump
不推荐
change1testfixhomepage- 太长一大串句子
适用于你项目的任务分类
A 类：直接改
这些通常别走 OpenSpec：
- 改按钮颜色
- 改标题文案
- 改 margin/padding
- 改一个固定跳转地址
- 修一个明显的小样式 bug
B 类：推荐 OpenSpec
这些最适合：
- 首页新增“联系客服”
- 个人中心新增“签到入口”
- 商品详情新增“服务说明”
- 订单页新增“状态筛选”
- 首页 banner 点击逻辑优化
- 列表页增加一个简单业务交互
C 类：必须先 explore 或 propose
这些别直接硬改：
- 登录授权流程调整
- 订单状态流改动
- 支付相关流程
- 涉及后端 API 联动
- 同时影响 uniapp + PHP 后端 + admin/store
一套你能每天用的判断法
先问自己 3 个问题
1. 是不是只改 1 个文件、几十行以内？
如果是，直接改
2. 是不是会涉及多个文件/多个组件？
如果是，先 /opsx-propose
3. 我是不是还没想清楚影响范围？
如果是，先 /opsx-explore
你这个仓库里，建议优先关注哪些目录
如果是小程序二开，优先只围绕：
yoshop2.0-uniapp/pages/yoshop2.0-uniapp/components/yoshop2.0-uniapp/utils/yoshop2.0-uniapp/config.jsyoshop2.0-uniapp/api/或请求相关目录
默认不要顺手扩大范围到
yoshop2.0-admin/yoshop2.0-store/yoshop2.0/后端
除非这次需求明确要动。
最实用的几个命令模板
模板 1：新增首页入口
/opsx-propose add-home-xxx-entry
/opsx-apply add-home-xxx-entry
/opsx-archive add-home-xxx-entry模板 2：新增详情页模块
/opsx-propose add-product-detail-xxx-section
/opsx-apply add-product-detail-xxx-section
/opsx-archive add-product-detail-xxx-section模板 3：先分析再做
/opsx-explore 订单页增加筛选会影响哪些文件和接口？
/opsx-propose add-order-filter
/opsx-apply add-order-filter对你最有价值的使用习惯
推荐习惯 1
不要为纯样式改动开 OpenSpec
推荐习惯 2
一个 change 只做一件事 不要一个 change 里同时塞：
- 首页入口
- 商品详情改动
- 个人中心菜单
- 订单筛选
否则后面会乱。
推荐习惯 3
优先用中文描述需求，英文命名 change 比如你可以输入：
/opsx-propose 在首页增加联系客服入口让工具帮你整理；但如果你自己命名，尽量英文 kebab-case。
推荐习惯 4
小程序二开优先限制在 yoshop2.0-uniapp/
这样最省 token，也最稳。
一句话工作流
想不清
/opsx-explore ...想清了
/opsx-propose ...开始改
/opsx-apply ...做完收尾
/opsx-archive ...如果你要，我下一步可以直接帮你做一个：
适合当前项目的第一个真实示范 change
比如你随便给我一个小需求，我直接告诉你：
- 应不应该用 OpenSpec
- 应该用哪条
/opsx-* - change name 怎么取
- 第一条命令具体怎么输