1. 一个“一句话需求”引发的翻车现场上周同事阿豪在群里吐槽“AI 写的代码根本跑不通”原来他扔给 ChatGPT 一句极简需求“帮我写个 Python 脚本把 CSV 转成 JSON。”结果 AI 返回了 40 行“看似合理”的代码文件路径硬编码、没处理编码异常、没考虑空值、字段名写死为col1, col2, col3……阿豪复制粘贴后直接投产当晚日志疯狂报错客户电话打爆。这就是低质量指令的典型代价代码不完整、逻辑漏洞、返工时间翻倍。2. 方法论速览CRISP vs PEARL先给两套主流框架打个标签方便按需取用。框架关键词适用场景CRISPContext, Role, Input, Steps, Parameters单任务、流程清晰、需要“步骤拆解”的脚本生成PEARLProblem, Example, Architecture, Refine, Limit多轮对话、需求模糊、需要“先给例子再细化”的复杂模块一句话总结“写完就能跑”的小工具 → CRISP“需求说不清还得一起想”的系统 → PEARL。3. 结构化指令模板把 AI 当成“外包团队”而非“许愿池”把指令拆成 3 层可复用、可维护、可灰度。角色定义Role让 AI 进入“开发者模式”减少幻觉。任务分解Task Decomposition把“大需求”拆成“可验证的子任务”每一步都给出验收标准。输出约束Output Constraints规定语言、格式、异常处理、注释风格甚至变量命名规范。模板骨架直接复制即可改Role: 你是一名有 8 年 Python 经验的后ackend 工程师熟悉 pandas、pytest、PEP8。 Task: - 读取任意编码的 CSV 文件自动探测分隔符。 - 对空值、重复行做清洗并打印统计信息。 - 将结果以 UTF-8 JSON 数组形式写出文件路径由命令行参数传入。 Output Constraints: - 使用 pandas 与 argparse 标准库不引入第三方包。 - 所有函数须带 docstring并包含 2 句 usage example。 - 必须捕获 FileNotFoundError、UnicodeDecodeError给出 exit code 1。 - 返回仅源码不附带解释。4. 代码生成实战Python JavaScript 双示例下面用“结构化模板”跑一遍看 AI 如何一次到位。4.1 PythonCSV → JSONPrompt直接喂给 ChatGPTRole: …同上略 Task: …同上略 Output Constraints: …同上略 额外要求 - 函数式风格main() 入口。 - 包含 if __name__ __main__ 保护。 - 提供单元测试使用 pytestmock 一个含空值与重复行的 csv。AI 返回已验证可跑import argparse import json import sys from pathlib import Path import pandas as pd def read_and_clean(csv_path: Path) - pd.DataFrame: 读取 CSV 并清洗空值与重复行。 Examples -------- df read_and_clean(data.csv) print(df.shape) try: df pd.read_csv(csv_path, sepNone, enginepython) except (FileNotFoundError, UnicodeDecodeError) as exc: print(exc, filesys.stderr) sys.exit(1) print(f原始行数: {len(df)}) df df.dropna(howall).drop_duplicates() print(f清洗后行数: {len(df)}) return df def write_json(df: pd.DataFrame, out_path: Path) - None: 写出 JSON 数组。 out_path.write_text(df.to_json(orientrecords, force_asciiFalse), encodingutf-8) def main(): parser argparse.ArgumentParser() parser.add_argument(csv_file, typePath) parser.add_argument(json_file, typePath) args parser.parse_args() df read_and_clean(args.csv_file) write_json(df, args.json_file) if __name__ __main__: main()pytest 用例AI 也顺手给了import tempfile import pandas as pd from pathlib import Path from csv_to_json import read_and_clean def test_read_and_clean(): raw a,b\n1,2\n, \n1,2\n with tempfile.NamedTemporaryFile(modew, suffix.csv, deleteFalse) as f: f.write(raw) f.flush() df read_and_clean(Path(f.name)) assert len(df) 1 assert df.iloc[0][a] 14.2 JavaScriptNode-RED 脚本节点Prompt 把“角色”换成“资深全栈熟悉 ES2022”输出约束加“使用 ESM、JSDoc 注释、返回 Promise”。AI 产出/** * Convert CSV file to JSON array. * param {string} csvPath * param {string} jsonPath * returns {Promisevoid} */ import { promises as fs } from fs; import { parse } from csv-parse; export async function csvToJson(csvPath, jsonPath) { const parser fs.createReadStream(csvPath).pipe(parse({ columns: true, bom: true })); const records []; for await (const row of parser) { if (Object.values(row).some(v v?.trim())) records.push(row); } const unique Array.from(new Map(records.map(r [JSON.stringify(r), r])).values()); await fs.writeFile(jsonPath, JSON.stringify(unique, null, 2), utf8); }两段代码均一次性通过基础测试返工率为 0。5. System Prompt给 AI 戴上“紧箍咒”把领域知识、安全规范写进 System Prompt能显著降低幻觉率。模板示例You are CodeGen-Bot. Knowledge cutoff: 2023-10. Follow the rules: - Never hard-code credentials. - Prefer standard library over DIY. - Output only code and comments, no apology or explanation. - If asked for SQL, always use parameterized queries.实测把这段设为 system 后再让 AI 写数据库脚本它会自动占位?或%s省去反复提醒。6. Token 效率与成本优化精简历史多轮对话只保留“最后 3 轮用户输入 AI 输出”其余丢弃可减少 30% Token。动态 max_tokens预估返回长度设上限。例如生成单函数时给 400 token 足够别全开 4k。缓存重复指令把常用“角色 约束”存成本地常量每次只传“增量需求”省 15% 输入长度。批量生成一次 Prompt 要 5 组示例让 AI 一起写再本地拆分比 5 次 RTT 节省 40% 费用。7. 生产环境避坑指南7.1 敏感信息泄露防护在指令里显式加一句“禁止生成任何 API Key、密码、私钥占位符”。用静态扫描工具如 detect-secrets做 CI 卡点AI 产出代码先过扫描再入库。7.2 输出结果校验方案对生成代码跑单元测试 lintblack、eslint0 warning 才合并。对 JSON/YAML 配置用 JSON Schema 校验字段完整性。高阶玩法把 AI 输出喂给 LangChain 的 “output parser”自动对齐 Pydantic 模型失败即重试。7.3 版本迭代时的指令兼容性把指令拆成“稳定头 可变尾”头文件放 GitPR review 时只改尾。发版前跑回归集固定 20 组历史 Prompt对比新旧模型输出 diff超过 5% 字符变动就人工复核。使用 Canary Prompt先切 5% 流量到新指令错误率飙升立即回滚。8. 开放式问题如何构建团队级指令知识库用 Docs-as-Code 思路Markdown 存指令、PR 评审、CI 跑例程。打标签语言、框架、安全等级、业务域方便检索。引入 embedding 检索把指令向量化新人输入自然语言即可拉回相似模板。定期“指令腐烂”巡检业务变更后对应 Prompt 是否同步谁负责最后指标化统计每个指令的采纳率、测试通过率、线上故障关联度让“好 Prompt”浮出水面。把上面这些套路串起来我已经能把 AI 从“玄学写手”调教成“靠谱外包”。如果你也想亲手搭一套“能听会说”的 AI 伙伴不妨试试这个动手实验——从0打造个人豆包实时通话AI。实验把 ASR→LLM→TTS 整条链路拆成 5 个可运行的小模块跟着敲一遍就能把本文的指令工程方法搬到实时语音场景。小白也能顺利体验我实际跑通只花了午休时间推荐你试试。