企业官网建设流程全解析

zerostack是一个用 Rust 编写的轻量级 AI 编码 Agent，主打低内存占用与高性能。它的灵魂不在模型，而在一套可切换的Prompt 系统：内置14 个模式 Prompt，覆盖从头脑风暴、规划、写代码到审查的完整研发流程，并支持brainstorm → plan → code的链式工作流，让 AI 按你的节奏一步步推进，而不是胡乱动手。

一、什么是 zerostack Prompt 系统

在 zerostack 里，Prompt 不只是"提示词文本"，而是一种"工作模式"。每个 Prompt 是一段 Markdown 文件，规定了 Agent 在该模式下的行为边界、工具权限、流程步骤与安全规则。切换 Prompt，等于给 Agent 换上不同的"人格与纪律"。

所有内置 Prompt 位于 data/prompts/ 目录，加载逻辑见 src/context/prompts.rs。它最巧妙的地方是：每个 Prompt 文件首行可写一条%%mode=指令，激活时自动切换对应的安全模式——也就是说，"选什么 Prompt" 和 "允许 AI 做什么" 被绑定在了一起，既省心又安全。

二、14 个内置 Prompt 全景图

zerostack 把研发全流程拆成了清晰的模式。下面是 14 个内置工作模式 Prompt一览（另有 2 个元级 Prompt：default自动分派兜底、orchestrator并行任务编排）：

每个模式都有明确的"工具纪律"。例如 data/prompts/brainstorm.md 规定"只用 read/grep/find_files/list_dir，禁止 write/edit/bash"，data/prompts/plan.md 则"必须先经用户批准才能进入实现"。用对 Prompt，AI 才不会越权。

三、一键切换：/prompt 命令怎么用

在交互界面里，切换 Prompt 有三条捷径（详见 docs/COMMANDS.md）：

• /prompt— 列出所有可用 Prompt，进入选择器
• /prompt <name>— 直接激活某个 Prompt，并自动应用该文件里的%%mode=
• /prompt default— 清除当前激活的 Prompt
• 快捷前缀.code、.ask、.plan等，等价于/prompt code
• Alt+P— 打开模糊过滤的 Prompt 切换器

💡 提示：除了/prompt，你还能用快捷键前缀（如.plan）或--load-prompt plan命令行参数在脚本/无头模式下指定模式。

四、%%mode 指令：每个 Prompt 自带安全模式

这是 zerostack Prompt 系统最有安全感的特性。解析逻辑见 src/permission/mod.rs，文档见 docs/CONFIG.md。

在 Prompt 文件第一行写上%%mode=<模式>，激活该 Prompt 时就会自动切换到对应安全模式，指令行本身不会进入模型上下文。可用模式有：standard/restrictive/readonly/planwrite/guarded/yolo，以及特殊的last_user_mode（保留用户当前的模式）。

内置 Prompt 的%%mode分配很有讲究：

这样一来，"头脑风暴"永远不会误改代码，"代码审查"天然只读——权限随场景自动收放，新手也能放心用。

五、brainstorm → plan → code 链式工作流

zerostack 最顺滑的体验是Prompt 链（Chain-of-Prompts）。开启后，当 Agent 用brainstorm、plan或code完成回复，状态栏会弹出Continue to plan? [Yes/But/No]，让你用键盘"接力"进入下一阶段，无需手动重新切换 Prompt。

整个链的实现非常简洁，集中在 src/extras/chain/mod.rs：

• brainstorm → plan：自动注入"基于上面的头脑风暴，创建详细实现计划"
• plan → code：自动注入"实现上面的计划，写代码、测试并验证"
• code → review：自动注入"审查这些改动"

三种回答方式（解析见parse_chain_decision）：

• Yes（y/yes）— 切换到下一个 Prompt 并自动提交过渡指令
• But（but <msg>/b <msg>）— 同 Yes，但把<msg>作为额外指令前置
• No（n/no）— 放弃链式，继续当前对话

链的开关在配置文件[chain]中控制（配置项定义见 src/config/types.rs，说明见 docs/CONFIG.md）：

🚀 实战体验：输入一个想法 →/prompt brainstorm→ 让 AI 发散 → 按y进入plan→ 审批方案 → 按y进入code→ 落地代码。思路、方案、代码一气呵成，且每一步都有刹车。

六、自定义 Prompt：优先级与存放目录

想让 AI 按你团队的口味干活？只需新建一个.md文件即可，同名文件会覆盖内置 Prompt。加载优先级（从低到高）为：内置（编译进二进制） < 全局目录 < 项目data/prompts/< 项目.zerostack/prompts/< 命令行--prompts-dir（后者可重复，靠后者胜出）。具体实现见 src/context/prompts.rs。

• 个人全局：~/.config/zerostack/prompts/
• 项目级：.zerostack/prompts/或data/prompts/

此外，zerostack 还支持[prompt_to_model]映射——切换到某个 Prompt 时自动切换到对应模型，让"规划用强模型、编码用快模型"成为默认行为（详见 docs/CONFIG.md）。用/regen-prompts可一键把内置 Prompt 恢复到全局目录。

七、快速上手清单

• 用/prompt浏览全部模式，先熟悉 14 个 Prompt 的分工
• 做新想法时从/prompt brainstorm起步，避免 AI 过早写代码
• 开启[chain]，体验 brainstorm → plan → code 的链式接力
• 用.code、.ask等前缀快速切换常用模式
• 在.zerostack/prompts/放入团队专属 Prompt，统一 AI 风格
• 用/regen-prompts把改乱的内置 Prompt 恢复出厂

zerostack 的 Prompt 系统，把"用什么 AI 姿态工作"变成了像选工具一样简单的事。模式越多越专注，AI 越可靠。