fnvtk/soul
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
153b8d979545ceb788c0f752db77a76c94a70988
soul/开发文档/模板使用说明书.md
卡若 d781dc07ed Update remote soul-content with local content
2026-01-09 11:58:08 +08:00

5.1 KiB
Raw Blame History

全能开发模板使用说明书 (Master Guide) - 智能开发中台

核心逻辑: 本模板不仅是一堆文档，而是一套**“AI 驱动的虚拟团队”**。 使用心法: “拖入即激活”。每个文档都植入了特定角色的 System Prompt（系统提示词）。当你把某个文件发给 AI 时，AI 就会瞬间“附身”为该领域的专家（如 CFO、CTO、架构师），为你解决具体问题。

1. 模板内幕与设计哲学 (The Philosophy)

这是一套基于**“云阿米巴”**思维构建的数字化生产线。

  • 去中心化: 每个文件夹代表一个独立职能部门。
  • 自生长: 文档不是死的，它会随着项目进度被 AI 自动更新（如 项目落地执行表）。
  • 角色化: 你不再是孤独的开发者，你是“指挥官”。你通过分发文档，指挥 AI (虚拟员工) 干活。

2. 全景操作指南 (The Operation Table)

决策核心: 遇到什么问题 -> 找哪个目录 -> 拖入哪个文件 -> 获得什么结果。

目录 (Directory) 对应部门/角色 关键文件 (Key File) 适用场景/决策点 (When to use) 预期产出 (Outcome)
1、需求 CFO (财务总监)
PO (产品负责人)		 成本.md
业务需求.md		 立项决策时：
1. 算不算得过账？(ROI)
2. 到底要做什么功能？		 - 详细的财务预算表
- 盈亏平衡点分析
- MVP 功能清单
2、架构 CTO (技术总监)
架构师		 技术选型.md
系统架构.md		 技术定调时：
1. 用 Python 还是 Java？
2. 要不要上向量库？
3. 系统怎么抗住高并发？		 - 技术栈清单
- 系统拓扑图
- 核心模块设计
3、原型 UI/UX 设计师 原型设计规范.md 界面设计时：
1. 页面长什么样？
2. 交互逻辑怎么走？		 - 页面线框图描述
- 交互流程说明
4、前端 前端工程师 前端开发规范.md 写页面代码时：
1. 样式怎么写 (Tailwind)？
2. 组件怎么拆？		 - 规范的 React/Vue 代码
- 统一的 UI 风格
5、接口 后端/前端 接口定义规范.md 前后端联调时：
1. API 路径怎么定？
2. 字段传什么？		 - Swagger/OpenAPI 文档
- 标准 JSON 响应格式
6、后端 后端工程师 后端开发规范.md 写业务逻辑时：
1. 数据库怎么查？
2. AI 接口怎么接？		 - 高性能 Python/Java 代码
- 完整的 Service 层逻辑
7、数据库 DBA (数据库管理员) 数据库管理规范.md 存数据时：
1. 表结构怎么设计？
2. 向量索引怎么建？		 - MongoDB/MySQL 建表语句
- 索引优化策略
8、部署 DevOps (运维) 项目程序提示词.md
自动化部署...md		 上线发布时：
1. 怎么部署到服务器？
2. 怎么配自动化流水线？		 - 启动脚本
- CI/CD 配置文件
- 线上环境配置
9、手册 技术客服/文案 使用手册提示词.md
落地方案提示词.md		 交付客户时：
1. 客户怎么用系统？
2. 怎么写营销文案？		 - 用户操作手册
- 商业落地方案
10、项目管理 PM (项目经理) 项目管理提示词.md 日常跟进时：
1. 进度卡在哪里？
2. 谁在拖后腿？		 - 项目落地执行表 (自动更新)
- 风险预警报告

3. 深度使用技巧 (Pro Tips)

3.1 联动组合拳 (Combo)

不要只用一个文件，要学会组合：

  • 场景：我要做一个 AI 客服功能。
    • 第一步 (定钱)：拖入 1、需求/成本.md -> 问 AI：“加这个功能要多少 API 成本？”
    • 第二步 (定架构)：拖入 2、架构/技术选型.md -> 问 AI：“用 LangChain 还是原生调用？”
    • 第三步 (定落地)：拖入 10、项目管理/项目管理提示词.md -> 指令：“把这个功能拆解成任务，加入执行表。”

3.2 智能自生长 (Self-Growing)

  • 规则：当你和 AI 确定了新的细节（比如确定了数据库字段），必须要求 AI 更新对应的文档。
  • 指令示例：“@AI，我们刚讨论的 User 表结构，请更新到 7、数据库/数据库管理规范.md 中。”
  • 结果：你的文档永远是最新的，不需要专门花时间去维护过期的文档。

4. 目录权限与维护责任 (Responsibility)

目录 维护责任人 (Owner) 谁不能乱动
1、需求 / 10、项目管理 卡若 (老板/PM) 程序员 (只读)
2、架构 / 5、接口 架构师 / Tech Lead 运营 / 实习生
4、前端 / 6、后端 对应开发人员 非技术人员
8、部署 运维 / 核心开发 所有人 (除授权外，涉及密钥安全)

总结：这套模板是你（卡若）的**“数字化外脑”**。它把你的经验固化成了 Prompt，让 AI 能随时按你的标准干活。用好它，你就是一支队伍。