添加一家公司

This commit is contained in:
andy committed 2026-09-09 15:47:32 +08:00
1 parent 3bce336b6c
commit 32bee57df6
12 files changed
+136 -27

No files matched your search

@@ -2,7 +2,7 @@
| 项 | 内容 |
| --- | --- |
| Version | 0.2 |
| Version | 0.3 |
| Scope | 可复用软件工程标准 |
| Audience | 人类开发者、产品人员、架构师、AI Agent |
@@ -33,6 +33,12 @@ Prompt 是临时的,Context 是长期资产。重要知识应该沉淀在仓
文档不是一次性产物。文档随着项目成长,开发结束时文档也应该同步结束。
### Progressive Complexity
软件开发默认从简单到复杂。第一版应优先交付可运行、可验证的功能闭环,不为假想的未来复杂度提前引入过度抽象、复杂架构或难以理解的通用框架。
高级安全、高并发、性能优化、完整可观测性、复杂扩展性和容灾能力可以按风险和阶段后续迭代;但基础安全底线必须从第一版保留,包括 Secret 管理、基础权限边界、输入校验、敏感日志控制、数据隔离和错误响应脱敏。
### AI as Team Member
AI 不是单纯的代码生成器,而是项目成员。它可以参与需求分析、产品设计、架构设计、开发、Review 和维护。
@@ -210,12 +216,24 @@ Idea
Documentation Update 属于 Definition of Done,不能跳过。
### 8.1 Definition of Ready
### 8.1 Version Scope and Progressive Hardening
每个 Feature 或产品版本应显式区分:
- 第一版必须完成的功能闭环。
- 第一版必须保留的基础安全底线。
- 本阶段明确不做的高级安全、高并发、性能、可观测性、扩展性或容灾能力。
- 为后续迭代保留的低耦合边界和扩展点。
中文说明:第一版可以不追求完整平台化和高负载能力,但不能用“后续再做”为理由破坏基本安全、数据边界或模块职责。
### 8.2 Definition of Ready
进入实现前,复杂 Feature 或会影响跨模块协作的变更必须满足:
- 需求来源明确,知道是谁提出、解决什么问题。
- 目标和非目标明确,避免实现时扩大范围。
- 第一版范围、基础安全底线和后续加固项已经区分。
- 受影响的用户、业务流程、接口、数据模型、权限、安全、审计或外部系统边界已经列出。
- 前端、后端、测试或第三方系统的分工已经明确。
- 验收标准已经可测试,至少有主要 Given / When / Then 场景。
@@ -223,7 +241,7 @@ Documentation Update 属于 Definition of Done,不能跳过。
简单 bugfix 或纯内部重构可以不用新建完整 Spec,但仍应在任务说明中写清目标、范围和验证方式。
### 8.2 Definition of Done
### 8.3 Definition of Done
Feature 完成前必须确认:
@@ -233,7 +251,7 @@ Feature 完成前必须确认:
- 对外或跨团队契约发生变化时,调用方文档和测试说明已同步。
- 没有把 Secret、真实客户数据、构建产物、临时文件或无关本地变更纳入交付。
### 8.3 Change Request
### 8.4 Change Request
当一个已 Approved 或 Implemented 的 Spec 发生需求变更时,优先新增或更新 Change Request,而不是把讨论散落到聊天记录中。
@@ -249,7 +267,7 @@ Change Request 至少说明:
小变更可以直接追加到原 Spec 的“变更记录”章节;跨前后端、权限、安全、数据模型或第三方契约的变更应单独成文。
### 8.4 Traceability Matrix
### 8.5 Traceability Matrix
复杂 Feature 应维护需求追踪表,用于连接需求、实现、测试和文档。
@@ -261,7 +279,7 @@ Change Request 至少说明:
追踪表可以放在 Spec、Project State 或专项 checkpoint 文档中;关键是让新 Agent 能快速判断“文档写了但代码没做、代码做了但文档没写、后端做了但前端没做、前端需要但后端没做”。
### 8.5 Agent Handoff
### 8.6 Agent Handoff
给 AI Agent 分派任务时,建议使用统一交接结构:
@@ -281,6 +299,7 @@ Change Request 至少说明:
- 复杂功能默认先 Spec,不直接实现。
- Bug 默认先定位,不猜测修复。
- UI 默认保持一致性,不过度设计。
- 第一版默认先实现可验证的功能闭环,避免提前设计复杂平台化能力;高级安全和高并发能力可以后续迭代,但基础安全底线必须从第一版保留。
- 代码修改前先确认目标、边界和验收标准。
- 涉及接口、安全、权限、数据模型或外部系统时,先读相关契约文档。
- 涉及跨 agent 协作时,先确认 Spec、Change Request 或 handoff 是否足够清楚。