提示词速查

这篇文档给你的是“可以直接复制给 AI 的 Prompt 模板”。

重点不是写漂亮的话，而是让 AI 一开始就走对入口。

补充约定：

• 如果你的宿主支持 slash skill，直接输入 /技能名 的语义应是“立即执行该 skill 的默认工作流”。
• slash skill 不应该退化成“只展示 skill 定义”或“只确认已读取 skill”。

1. 使用前先记住五个字段

无论你要做什么，Prompt 里尽量都带上下面五类信息：

1. 项目路径
2. 项目当前状态
3. 第一优先动作
4. 不要做什么
5. 最后要输出什么

如果这五项里缺了三项以上，AI 很容易开始“凭感觉发挥”。

2. 场景总表

场景	推荐第一动作	模板位置	你应该期待的结果
空目录新项目	先初始化，不直接手写伪骨架	3	生成项目规则入口、内部控制面和 docs/，再进入需求阶段
新项目但目录状态不确定	先判断目录是否为空	4	AI 先告诉你应该初始化、纳管还是补规则入口
历史项目纳管	先建立真实状态基线	5	产出当前状态摘要、当前阶段判断、首批 BUG / CR / TASK 建议
半初始化项目补齐规则入口	先补项目规则入口	6	补齐规则入口，再做状态诊断和阶段检查
已纳入软件工厂后继续工作	先读取规则和当前状态	7	AI 先确认当前阶段和第一步，再推进本轮目标
已纳管项目升级 docs 到最新规范	先检查并执行 docs 标准升级	19	按需迁移旧 docs 结构、刷新索引和目录页，并输出人工复核点
批量扫描并通知项目负责人刷新 docs	先批量检查，再逐个生成通知	20	得到项目清单、状态汇总和可直接转发的通知模板
不确定下一步	先做诊断	8	得到当前阶段、阻塞项和下一步建议
继续需求阶段	先读规则入口和当前状态	9	补齐 PRD、需求分析、需求校验，避免直接编码
启动设计阶段	先读需求，再补设计	10	补齐技术选型、架构、模块边界、API、UX/UI
根据设计生成 OpenAPI	先读 API 设计与模块边界	11	生成或补齐 OpenAPI 契约，并指出设计缺口
启动迭代计划和任务拆分	先建计划，不直接大任务实现	12	产出实施计划、WBS、任务分解和首批 TASK-*
实施单个 TASK	先确认影响范围	13	改代码、测、同步文档和记忆
新增 BUG	先判断影响范围	14	建立 BUG 入口并完成修复闭环
新增 CR	先做影响分析	15	更新需求与设计，拆任务，再决定是否进入实现
发布前检查	先做检查再决定是否发布	16	输出是否可发布、缺口和高风险项
交接给下一位协作者	先读当前状态和活跃工作项	17	生成交接摘要、阻塞项和接手建议
只做评估不改文件	先约束为“只分析”	18	AI 只给评估，不动项目文件

3. 空目录新项目初始化

什么时候用

• 你要创建一个全新项目
• 目标目录是空的

Prompt 模板

项目路径是：[项目路径]

这是一个空目录新项目。
请先执行 `factory-init`，不要手工生成一套伪初始化文档。

项目名称：[项目名称]
中文名：[中文名，可选]
核心创意：[一句话或一段话描述]
技术栈倾向：
- 前端：[前端技术]
- 后端：[后端技术]
- 数据库：[数据库]
- 其他关键组件：[可选]

执行要求：
1. 如果目录为空，先完成初始化
2. 初始化完成后，列出关键产物：
   - 项目规则入口
   - 内部控制面
   - `docs/` 下的关键入口
3. 然后再启动需求阶段
4. 不要跳到实现阶段
5. 如果目录非空，不要伪初始化，直接告诉我应改走“历史项目纳管”还是“补齐规则入口”

预期结果

• AI 先做初始化，不会直接凭空写一套伪文档
• 初始化后会明确列出关键产物
• 下一步应进入需求阶段，而不是直接实现

4. 新项目，但你不确定目录是否为空

什么时候用

• 你想新建项目，但不确定目标目录当前状态

Prompt 模板

项目路径是：[项目路径]

我准备在这里创建一个新项目，但我不确定目录当前是否为空。
请先检查目录状态。

如果目录为空：
- 先执行 `factory-init`
- 初始化完成后列出关键文件
- 再启动需求阶段

如果目录非空：
- 不要直接初始化
- 先判断它更像“历史项目纳管”还是“半初始化项目补齐”
- 告诉我正确的入口和原因

项目名称：[项目名称]
核心创意：[项目创意]
技术栈倾向：[技术栈]

预期结果

• AI 会先判断目录状态
• 不会在非空目录里硬做新项目初始化

5. 历史项目纳管

什么时候用

• 项目已经有代码和运行方式
• 但还不是软件工厂项目

Prompt 模板

项目路径是：[项目路径]

这是一个已经开发完成、但不是用软件工厂完成的历史项目。
请不要把它当成空目录新项目，不要直接调用 `factory-init`。

请先基于下面信息建立“当前真实状态基线”：
- 当前代码
- 配置文件
- 现有文档
- 最新发布结果
- 可用运行方式

项目名称：[项目名称]
当前主要技术栈：[技术栈]
当前已知运行方式：[启动/构建/部署方式]
当前目标：[比如先纳管，再修 Bug]

然后请再补齐：
- 项目规则入口
- 内部控制面
- 当前阶段所需 `docs/`

要求：
1. 先告诉我当前真实状态摘要
2. 再告诉我建议的软件工厂当前阶段
3. 再告诉我首批应创建的 BUG / CR / TASK
4. 不要在纳管前直接开始大规模编码

预期结果

• AI 会先做现状基线，而不是直接改代码
• 你能得到当前阶段判断和后续第一批工作项建议

6. 半初始化项目补齐规则入口

什么时候用

• 项目已经有 docs/
• 已经有部分运行痕迹
• 但项目规则入口不完整

Prompt 模板

项目路径是：[项目路径]

这是一个半初始化项目。
当前已经有 `docs/` 和部分运行痕迹，但项目规则入口还不完整。

请不要重做整套初始化，也不要重写现有需求和设计文档。

先按下面顺序处理：
1. 检查已有正式文档、仓库结构和当前运行痕迹
2. 判断这是“规则入口缺失”还是“纳管未完成”
3. 如果适用，优先使用 `factory-project-rules-refresh` 补齐规则入口
4. 然后执行状态诊断和阶段检查

最后告诉我：
1. 新增或修复了哪些文件
2. 当前项目还缺什么
3. 下一步最推荐做什么

预期结果

• AI 会补齐规则入口，而不是重建项目
• 你会得到修复清单和下一步建议

7. 已纳入软件工厂后继续工作

什么时候用

• 项目已经有完整软件工厂骨架

Prompt 模板

项目路径是：[项目路径]

这个项目已经纳入软件工厂。
请先按项目规则入口、当前状态摘要和相关 summary 读取必要上下文，不要默认读取当前阶段正式文档。

然后继续处理下面这件事：
[当前目标]

要求：
1. 先告诉我当前阶段
2. 先说明你准备执行的第一步
3. 禁止默认把阶段 `docs/` 文档列入“先读”；只有事实不足时才单文件回源相关正式文档
4. 完成后同步更新代码、文档、测试和内部控制面摘要

预期结果

• AI 会先读规则和当前状态
• 不会跳过阶段约束直接执行

8. 不确定下一步时先做诊断

什么时候用

• 你不知道项目现在卡在哪
• 你不确定应该继续需求、设计还是实现

Prompt 模板

项目路径是：[项目路径]

请先生成一次 `factory-agent-session` 和 `factory-state-doctor`。
输出请告诉我：
1. 当前阶段
2. 当前阻塞项
3. 缺失的关键文档或规则入口
4. 最推荐的下一步
5. 现在最应该优先处理的 BUG / CR / TASK

预期结果

• 你会先得到诊断结果
• 后续可以基于诊断再决定继续做什么

9. 继续需求阶段

Prompt 模板

项目路径是：[项目路径]

这个项目已经纳入软件工厂。
请先读取规则入口和当前状态，然后继续需求阶段。

本轮目标：
- 补齐 `prd.md`
- 补齐 `requirements-analysis.md`
- 补齐 `requirements-verification.md`

要求：
1. 不要改变当前已确认范围，除非先指出冲突
2. 不要直接开始编码
3. 输出时告诉我还缺哪些关键需求信息

预期结果

• 需求文档更完整
• AI 会在需求层收口，不会直接跳实现

10. 启动设计阶段

Prompt 模板

项目路径是：[项目路径]

需求已确认，请启动设计阶段。
请先读取规则入口、当前状态和需求文档，再补齐：
- `technical-selection.md`
- `system-architecture.md`
- `module-boundaries.md`
- `api-design.md`
- `ux-ui-design.md`

要求：
1. 如果发现需求还不完整，先指出缺口
2. 不要直接进入实现
3. 输出时告诉我设计还缺哪些高风险决策

预期结果

• AI 会补齐设计文档
• 如果需求前置不完整，会先指出而不是硬推进

11. 根据设计生成 OpenAPI 契约

什么时候用

• 已经有 API 设计和模块边界
• 你需要机器可消费的接口契约

Prompt 模板

项目路径是：[项目路径]

请先读取：
- `api-design.md`
- `module-boundaries.md`
- 相关端或模块设计文档

然后基于当前设计补齐 OpenAPI 契约文件。

要求：
1. 不要脱离现有设计凭空创造接口
2. 如果设计不够支撑 OpenAPI，请先列出缺口
3. 输出时告诉我：生成了哪些 OpenAPI 文件、覆盖了哪些模块或端

预期结果

• 生成或补齐 OpenAPI 契约
• 如果设计还不够，AI 会先指出缺口

12. 启动迭代计划和任务拆分

Prompt 模板

项目路径是：[项目路径]

基于当前已确认的需求和设计，请启动开发计划阶段。
请先生成：
- `implementation-plan.md`
- `wbs.md`
- `task-breakdown.md`
- 首批 `TASK-*`

要求：
1. 不要把整个实现压成一个大任务
2. 任务要能逐步推进
3. 输出时告诉我首批任务的拆分依据和推荐顺序

预期结果

• 会得到可执行的开发计划和首批任务
• 不会把所有工作压成一个超大任务

13. 实施单个 TASK

Prompt 模板

项目路径是：[项目路径]

这个项目已经纳入软件工厂。
请先读取规则入口、当前状态和相关设计文档。

现在只推进这个任务：
[TASK 编号或任务描述]

要求：
1. 先确认影响范围
2. 再实施代码改动
3. 同步更新测试、文档和内部控制面摘要
4. 不要顺手扩写成无关的大改
5. 最后告诉我：改了什么、测了什么、还缺什么验证

预期结果

• AI 会围绕单个任务推进
• 结果会同步到代码、测试、文档和记忆

14. 新增 BUG

Prompt 模板

项目路径是：[项目路径]

这个项目已经纳入软件工厂。
请先读取规则入口和当前状态。

现在新增一个 BUG：
[Bug 描述]

要求：
1. 先判断影响范围
2. 创建或更新 BUG 工作项
3. 再修复代码、测试、文档和内部控制面摘要
4. 最后按下面结构输出：
   - 根因
   - 影响范围
   - 修复结果
   - 还需要补的验证

预期结果

• BUG 会被纳入正式工作流
• AI 会给出根因、影响范围和修复验证

15. 新增 CR

Prompt 模板

项目路径是：[项目路径]

这个项目已经纳入软件工厂。
请先读取规则入口和当前状态。

现在新增一个 CR：
[需求变更描述]

要求：
1. 先做影响分析
2. 先更新需求和设计，再决定是否进入实现
3. 生成首批任务拆分
4. 不要跳过正式记录直接编码

预期结果

• AI 会先走影响分析和文档更新
• 实现动作会延后到正式判断之后

16. 发布前检查

Prompt 模板

项目路径是：[项目路径]

请对当前项目做一次发布前检查。
先读取规则入口、当前状态、当前阶段文档和最近执行记录。

请输出：
1. 当前是否适合进入发布
2. 缺失的关键文档
3. 未完成的高风险项
4. 建议先补的动作

预期结果

• AI 会给出是否可发布的判断
• 会明确缺口和高风险项

17. 交接给下一位协作者

Prompt 模板

项目路径是：[项目路径]

请准备一次项目交接。
先读取规则入口、当前状态、活跃工作项和最近执行记录。

请生成：
1. 当前阶段摘要
2. 当前阻塞项
3. 接手人必须先读的文件
4. 下一步最推荐动作
5. 必要的交接材料

预期结果

• 生成交接摘要
• 交代当前阻塞和接手入口

18. 只做评估，不改文件

什么时候用

• 你还不想让 AI 真的动项目
• 你只想先判断方向

Prompt 模板

项目路径是：[项目路径]

现在先不要修改任何文件，也不要改代码。
请只做评估。

评估目标：
[你想评估的事情]

输出请按下面结构给我：
1. 当前状态摘要
2. 缺失的关键资产
3. 建议的第一步
4. 如果开始做，最小改动范围是什么
5. 主要风险是什么

预期结果

• AI 只做分析，不执行真实改动

19. 已纳管项目升级 docs 到最新源文档标准

什么时候用

• 项目已经具备项目规则入口、内部控制面和 docs/
• 你要把现有 docs 刷到最新源文档标准
• 你希望自动迁移旧 docs 结构、刷新根目录和相关概览页

Prompt 模板

项目路径是：[项目路径]

这个项目已经纳入软件工厂。
请不要重新初始化，也不要重写整套 docs。

本轮目标：
- 按最新山海工枢源文档标准重构 `docs/`
- 修正根 `docs/index.md` 和相关目录 `index.md`
- 保留现有人工标题、顺序和必要的访问控制例外

请按下面顺序执行：
1. 先按项目规则入口、当前状态摘要和相关 summary 读取必要上下文；不要默认全文读取当前 `docs/`
2. 先判断项目是否已经被山海工枢正式接管；如果没有，停止本轮升级并告诉我应先走“历史项目纳管”
3. 使用 `document-templates` skill 完成文档重构，不要调用 `factory-docs-*` 旧脚本
4. 完成后执行 `uvx --from docs-stratego docs-stratego source validate --repo-path "[项目路径]"`
5. 校验完成后再执行 `factory-state-doctor --scope docs`

要求：
1. 不要顺手修改无关代码
2. 不要继续使用 `factory-docs-*` 旧命令
3. 最后按下面结构输出：
   - 是否需要迁移旧 docs 结构
   - 实际刷新了哪些 docs 文件
   - 最终状态是否为 `就绪`
   - 还需要人工复核哪些导航、`access` 或契约页

预期结果

• AI 会优先使用 document-templates skill 重构文档，并用 docs-stratego CLI 校验
• 你会得到校验结果、人工复核点和最终 docs 状态

20. 批量扫描并通知项目负责人刷新 docs

什么时候用

• 你在维护多个山海工枢项目
• 你需要先找出哪些项目该刷新 docs
• 你需要给每个项目负责人一份可以直接执行的通知

Prompt 模板

shanforge 仓库路径是：[shanforge 路径]
待扫描根目录是：[工作区根目录]

请先生成一份统一通知模板，要求每个项目负责人在各自仓库里使用 `document-templates` skill 重构文档，并执行 `docs-stratego source validate`；先不要直接修改任何业务项目。

执行要求：
1. 不要调用 `factory-docs-*` 旧命令
2. 为每个项目负责人生成一份可直接转发的通知，不要省略命令
3. 如果项目还没被山海工枢接管，单独标记为“需先纳管”
4. 明确他们需要执行的 `docs-stratego` CLI 命令
5. 不要直接修改这些业务项目，除非我明确要求

每个项目负责人的通知必须包含：
- 项目路径
- 要执行的命令
- 预期结果
- 升级后需要人工复核的点

可直接转发给项目负责人的通知模板

[项目名] 需要按最新山海工枢 docs 源文档标准重构并校验一次 docs。

请在项目根目录完成文档修改后，执行下面两步：
1. 使用 `document-templates` skill 按 4 大模块重构 `docs/`
2. `uvx --from docs-stratego docs-stratego source validate --repo-path "[项目路径]"`

预期结果：
- `docs-stratego source validate` 会告诉你当前 docs 是否已经 `就绪`
- 根 `docs/index.md` 和相关目录 `index.md` 会符合最新规范
- 若仍有缺口，输出里会明确指出导航、权限或契约页问题

请升级后反馈：
- 是否需要迁移旧 docs 结构
- 最终是否为 `就绪`
- 是否还有需要人工复核的导航、`access` 或契约页

预期结果

• 你会先得到项目清单，而不是直接批量改动所有仓库
• 每个负责人都会拿到一份可执行、可反馈的统一通知

21. Prompt 末尾常用的约束句

下面这些句子可以按需拼到任何 Prompt 末尾。

防止 AI 直接乱编码

不要直接开始编码，先判断当前阶段和正式入口。

防止 AI 重写现有文档

不要重写整套现有文档，只在必要范围内补齐和修复。

防止 AI 在错误目录工作

所有动作都基于上面的项目路径，不要默认在当前会话目录操作别的项目。

让 AI 先给判断，再动手

先告诉我你判断的项目类型和第一优先动作，再开始执行。

22. 什么时候应该回看这篇文档

遇到下面任一情况时，回到这篇文档重新选模板：

• AI 把历史项目当新项目初始化
• AI 把半初始化项目当完整软件工厂项目
• AI 没有项目路径就开始动文件
• AI 跳过需求和设计直接实现
• 你发现自己的 Prompt 只有业务想法，没有动作约束