【增长】让AI写出不翻车的代码

function login(email, password) { ... }

/plugin install superpowers@claude-plugins-official

你说: "继续做反馈表单的下一步"
    ↓
AI 想: "这跟 brainstorming/writing-plans 有关"
    ↓
AI 调用 superpowers:writing-plans skill（这一步只加载 skill 正文，~1000 tokens）
    ↓
skill 正文里有指令: "先去 docs/superpowers/plans/ 找对应的 plan md 来读"
    ↓
AI 用 Read 工具读 feedback-form-plan.md
    ↓
基于读到的内容继续做事

"把 feedback-form.md 里 scope 改成 '游客 + 登录用户'，在 constraints 里加 '需要图片验证码防刷'。然后 review 一下整份文档还有哪些地方需要联动改。"

"audit 一下 docs/superpowers/specs/ 下所有 md，
 对照当前 main 分支代码，告诉我哪些已经过期。"

// 购物车模块里的代码
const tax = paymentModule.calculateTax(amount)  // ← 直接调支付模块的内部函数

def login_and_send_welcome_email（email， password）：
    # 1. 校验密码
    user = check_password（email， password）
    # 2. 生成 token
    token = create_jwt（user）
    # 3. 发欢迎邮件
    send_email（user.email， "Welcome!"）
    return token

def login（email， password）：
    user = check_password（email， password）
    token = create_jwt（user）
    return user， token   # 返回 user 和 token 两样

def send_welcome_email（user）：
    send_email（user.email， "Welcome!"）

user， token = login（email， password）
send_welcome_email（user）  # 单独调，挂了不影响登录拿到 token

# 伪代码示意 — 真实代码每个步骤里有大量错误处理 / 数据库事务 / 日志细节
def register（email， password）：
    if not validate_email（email）： return error      # 1. 校验邮箱
    if exists（email）： return error                  # 2. 查重
    hash = bcrypt（password）                         # 3. hash 密码
    user = db.insert（...）                           # 4. 写数据库
    token = create_jwt（user）                        # 5. 生成 token
    send_welcome_email（user.email）                  # 6. 发欢迎邮件
    log_event（"user_registered"， user）              # 7. 写日志
    track_analytics（"signup"， user.id）              # 8. 埋点分析
    return {"user"： user， "token"： token}

utils.js  ← 里面有时间格式化、邮箱校验、价格计算、URL 处理...

date-utils.js       ← 只放时间相关
email-validator.js  ← 只放邮箱校验
price-calculator.js ← 只放价格计算
url-helpers.js      ← 只放 URL 处理

def process_order（order）：
    # 30 行校验...
    # 20 行算税...
    # 30 行扣库存...
    # 20 行发邮件...
    # 30 行写日志...
    pass  # （Python 里函数体不能空，真实代码会有 130+ 行）

def process_order（order）：
    validate（order）
    tax = calc_tax（order）
    reserve_stock（order）
    notify_user（order）
    log_event（order）

db.py（数据库底层）
    ↓ 调用
user-service.py（业务层）

user-service.py（业务层）
    ↓ 调用
db.py（数据库底层）

# db.py（数据库底层）
from user_service import User, validate_email, is_vip   # ← 反过来抓业务层

def save(data):
    if not validate_email(data["email"]):    # ← 校验邮箱？这是业务层的活
        return "邮箱不合法"
    
    user = User(data)                         # ← 创建 User 对象？这也是业务概念
    
    if is_vip(user):                          # ← 判断 VIP？业务概念跑进数据库了
        cursor.execute("INSERT INTO vip_users ...")
    else:
        cursor.execute("INSERT INTO users ...")

// payment.js （内部函数，不应该被外部直接调）
function calculateTax（amount） {
  return amount * 0.13  // 内部税率细节
}

// cart.js
import * as payment from "./payment.js"
const tax = payment.calculateTax（amount）  // 伸手到内部细节

// payment.js — 对外暴露一个清晰的接口
export function getOrderTax（order） {
  return calculateTax（order.amount）  // 内部细节支付自己管
}

// cart.js
import { getOrderTax } from "./payment.js"
const tax = getOrderTax（order）  // 通过接口

def handle_payment（order_id， user_id， amount）：
    # 1. 查订单（20 行）
    # 2. 验用户（15 行）
    # 3. 校金额（20 行）
    # 4. 调 Stripe API（40 行）
    # 5. 写数据库（30 行）
    # 6. 发邮件（35 行）
    # 7. 写日志（40 行）
    pass  # （伪代码示意，真实有 200+ 行）

def handle_payment（order_id， user_id， amount）：
    order = get_order（order_id）
    user = get_user（user_id）
    validate（order， user， amount）
    receipt = charge_stripe（amount）
    save_payment（order， receipt）
    notify_user（user， receipt）
    log_payment（order， receipt）