概要设计书自动生成 Agent

项目简介

本项目的目标是开发一个 Web 服务形态的 Agent，能够读取 Excel 版要件定义、概要设计做成说明书、概要设计模板、概要设计书记入规则和图表规则等输入资料，自动生成符合规范的 Word 版概要设计书。

交流语言

本项目的所有 AI 交流、文档、注释、代码中的文本，统一使用中文。不得使用日文、英文或其他语言进行交流（专有名词、技术术语、代码关键字等不可避免的情况除外）。

技术栈

后端: Python
前端: Web UI
LLM: DeepSeek / Qwen等
文档处理: python-docx, docxtpl, openpyxl
Agent 架构: 多 Agent 协作（Parser / Impact / Writer / QA）

项目结构

Genesis/
├── AGENTS.md              # 本文件 - OpenCode 指令文件
├── _AI_USAGE_LOG.md       # AI 使用日志（自动生成）
├── docs/                  # 大赛规则、设计文档等
├── src/                   # 源代码
├── samples/               # 样本输入文件（脱敏）
└── README.md              # 安装与运行说明

开发范式

本项目的开发遵循以下步骤，每一步骤名称对应 _AI_USAGE_LOG.md 中的"范式步骤"列：

需求理解 — 分析大赛规则，理解概要设计书生成需求
架构设计 — AI 生成方案，人工审核设计
Agent 实现 — AI 编码实现各 Agent 模块
测试验证 — 单元测试与集成测试验证
反馈迭代 — 基于测试结果反馈修正

日志规则（自动执行）

每次创建或修改代码、文件后，在项目根目录的 _AI_USAGE_LOG.md 中追加一条记录，必须包含以下字段：

日期时间	范式步骤	修改摘要	涉及文件	使用模型
2026-06-29 14:30	架构设计	完成Agent协作架构设计	docs/design.md	deepseek-chat

字段填写说明：

日期时间：AI 自动获取当前时间填写
范式步骤：初始写"待补充"，后续替换为上方开发范式中对应的步骤名称
修改摘要：简述本次修改的内容
涉及文件：列出被创建或修改的代码文件路径（每行一个）
使用模型：AI 使用的模型名称，若无法获取则手动填写

文档生成规则

所有会话中生成的设计文档、方案、报告等内容，必须保存到 docs/ 目录下，不得在项目根目录或其他位置创建文档文件。

信息安全

不得将客户数据、公司信息上传至外部公开仓库
API Key 配置在环境变量或配置文件中，不得硬编码在源码
确认所有依赖的许可证类型，禁止使用盗版软件

2.8 KiB Raw Blame History Unescape Escape