先把主标语放首屏：需求不用写长，但要写够——够到能一次做对。本文不教话术，只给一把尺子：什么时候一句话就够，什么时候必须写细，以及"细"到底细在哪三处。

本文的主角是「安卓修改大师智改工坊」：一款 Windows 桌面工具，把"改 APK"从技术活变成一句话——拖入安装包，用中文写需求，AI 改包，改完自动回编 / 对齐 / 签名 / 校验，一键装到手机或模拟器看效果。介绍页在 https://www.apkeditor.cn/ai-version.aspx，官网是 www.apkeditor.cn。

一、两种浪费：写太粗与写太细

改包这件事上，需求写不好有两副面孔。一副是写太粗："把界面弄清爽点"。这句话省了你三十秒，却可能换来两轮返工——因为没人知道"清爽"意味着删什么、留什么、动几处。

另一副是写太细：把一次改应用名写成八百字文档，连文件名怎么改都规定好。这同样浪费时间，而且容易把注意力从"结果对不对"挪到"步骤像不像"上。真正的问题从来不是"该写多少字"，而是该写够哪几件事。

二、五个问题，决定你的需求该写多细

下面五个问题，每个问自己一句就够了。答案越偏向右侧，需求就越该写细。

五个问题里只要有一个落在"必须写细"那侧，就按详细需求来写。这条规则的好处是省掉纠结：不用判断"整体难不难"，只要看有没有踩到任何一条。

三、这些场景，一句话就够

不是所有改动都值得写长。下面这些场景，一句话配上"其它不动"，就足够清楚。

• 单点文案替换。"把关于页里的公司名改成『XX 科技』，其它不动。"一个位置、一眼可验，不需要额外描述。
• 应用名加后缀。"应用名改成『打卡助手 测试版』，其它不动。"改完看桌面名称即可。
• 版本号调整。"版本号抬一位，其它不动。"结果在应用信息里可直接核对。
• 换一张图，且约束说清。"把启动页背景换成附件里的图，保持原比例不拉伸，其它不动。"有了附件与这句约束，同样是一句话的事。

它们的共同点是：改动的落点唯一、结果肉眼可验、错了立刻能发现。这种改动写长反而有害——多余的描述会引入你并未真正检查过的假设。

四、这些场景，必须写细：范围、验收、约束

反过来，有四类场景建议直接按详细需求写。它们各自缺的，恰好是不同的一件东西。

• 批量改动，缺的是范围。一次动多处文案或资源时，必须写清"改哪几处、哪几处不许动"——不然"漏改"和"多改"两种错都会出现，且都不容易当场发现。
• 视觉素材替换，缺的是约束。换图、换背景、换图标这类改动，效果对错取决于比例、密度、位置这些约束写没写。
• 复合诉求，缺的是拆分。一条需求里塞了三件事，改错一件也说不清是哪件；拆成独立三条，各自可回溯、可重跑。
• 要复用或交接的需求，缺的是沉淀。以后还要重跑、或者要交给同事照着做的，范围和验收必须写进正文——因为在智改工坊里，附件说明不进历史，历史只留你的需求原话。

一条好记的界线：只要验收需要"逐条比对"，需求里就必须先有那条"条"——把清单写出来，验收才有对象。

五、两种模板：最小信息量与三件套

把上面的判断落成两个可以直接套用的模板。先套模板，再按判断标准决定用哪一个。

注意两个模板不冲突：详细需求并不是"不要一句话"，而是在那一句话后面多补两句。写起来仍然是几行字，区别只在于有没有把那三件事摆到明面上。

六、两个自家应用实例：一句话搞定的与必须写细的

实例一（一句话）：自家考勤 App 加"测试版"后缀

以前怎么做：团队自研的考勤 App「打卡助手」发给同事试用时，要在应用名后加"测试版"、顺手把版本号抬一位，避免与正式版混淆。手动流程是解包、改 strings.xml 的应用名、改 apktool.yml 的版本号、回编、对齐、签名、装机——每一步都是固定动作，但每次都要重来一遍。

现在一句话怎么做：拖入包，等后台解析与反编译完成，输入框写"应用名改成『打卡助手 测试版』，其它不动"，点「立刻修改」。AI 改完留下 ai_done.flag，主窗口 2 秒内轮询到就自动弹打包窗口，四步跑完。不需要范围清单，也不需要额外约束——落点就一个，写多了反而是负担。

改完怎么验证：打包后自动装到手机或模拟器并拉起，先看桌面名称，再进应用信息看版本号；两处都对就算过，全程不用一分钟。

实例二（必须写细）：自家盘点 App 的一次批量文案替换

以前怎么做：团队自研的门店盘点 App「盘点易」业务口径调整，要把三个页面里的"门店"统一改成"网点"。手动做这件事最怕两件事：一是漏改，翻遍资源文件仍有残留；二是多改，把不该动的地方（比如某个带"门店"字样的专有名词）一起替换掉。改完还得一个页面一个页面地点进去核对，像在做校对。

现在一句话怎么做：这类需求就按模板 B 写——范围："只改合同页、盘点页、上报页三处文案里的『门店』"；约束："其余文案与专有名词保持原样"；验收："改完进这三页逐条核对"。整段写下来也就三行，点「立刻修改」即可。这条需求原文与修改日期进 history.ini，详情页历史列表按时间倒序展示、完整不截断，右侧「选择」还能把这条填回输入框，下次口径再变直接重跑。

改完怎么验证：设备侧装好并拉起，进三个页面逐条核对；再用 dumpsys 确认前台应用是它。因为范围和验收都写进了需求正文，这条记录本身就能当作下一轮的作业清单——这正是"写细"真正的回报。

七、用户评价、合规提醒与结语

一份内部反馈汇总也有类似结论：认为"颗粒度选对"比"写得漂亮"更重要的同事最多，其次是"范围写清的返工最少"——这只是一次主观感受的汇总，不构成效果承诺。

收个尾：颗粒度不是文风问题，而是你愿意把多少次返工提前做掉。落点唯一的改动，一句"其它不动"就够；要翻页核对的改动，把范围、验收、约束摆到明面上。回到开头那句主标语：需求不用写长，但要写够——够到能一次做对。产品是安卓修改大师智改工坊，介绍页：https://www.apkeditor.cn/ai-version.aspx；官网 www.apkeditor.cn。