docs(GOV-003): 封存 Gitea 接入验证结果

docs(GOV-003): 配置项目专用 Gitea 远程仓库
docs(GOV-002): 封存 PRD 与审查门禁版本
2026-08-12 18:34:05 +08:00 · 2026-08-12 18:33:09 +08:00 · 2026-08-12 18:27:03 +08:00 · 2026-08-12 18:26:31 +08:00
57 changed files with 957 additions and 23 deletions
@@ -11,17 +11,19 @@

 1. 修改生产代码前必须执行 `npm run governance:start -- <功能编号> <短名称>`，刷新 GitNexus，并完成开发前影响分析。
 2. 修改完成后必须执行测试、构建、视觉验证和 `npm run governance:finish -- <功能编号> <短名称>`，再次刷新 GitNexus并保存前后对比。
-3. 任何功能必须先有 `docs/features/<功能编号>-<短名称>/` 功能档案；没有需求、设计、计划和回退说明不得视为完成。
+3. 任何功能必须先有 `docs/features/<功能编号>-<短名称>/` 功能档案；没有 PRD、需求、设计、计划和回退说明不得视为完成。
 4. Git 提交必须使用中文 Conventional Commit，并带功能编号；禁止英文摘要和含糊提交信息。
 5. 代码必须为关键业务逻辑、数据口径、异常恢复和架构取舍提供准确的中文注释；禁止无意义逐行注释。
 6. 文件按稳定职责拆分，不以追求“原子化”为目的过度拆分。优先保证普通开发者能够连续阅读完整业务流程。
-7. 不使用 GitHub。当前只使用本地 Git，远程仓库仅在用户安装 Gitea 后配置。
-8. 禁止提交密钥、真实凭据、生产数据、`.env` 和 GitNexus 本地索引。
+7. 不使用 GitHub。本项目唯一远程仓库为项目级配置的 Gitea `https://git.foximao.com/FoXiMao/a-share-analysis.git`；禁止修改 Git 全局配置或影响其他项目。
+8. 禁止提交密钥、密码、访问令牌、生产数据、`.env` 和 GitNexus 本地索引；凭据不得写入远程 URL、文档、脚本或命令参数。
+9. 开发完成后必须先通过代码 Review 和开发规范符合性 Review，再进入发布；Review 结论和问题处置必须写入功能档案。
+10. 添加远程不等于获得推送授权；除非用户明确要求，不得主动向 Gitea 推送提交或标签。

 <!-- gitnexus:start -->
 # GitNexus — Code Intelligence

-This project is indexed by GitNexus as **a-share-analysis** (171 symbols, 192 relationships, 0 execution flows). Use the GitNexus MCP tools to understand code, assess impact, and navigate safely.
+This project is indexed by GitNexus as **a-share-analysis** (361 symbols, 387 relationships, 0 execution flows). Use the GitNexus MCP tools to understand code, assess impact, and navigate safely.

 > If any GitNexus tool warns the index is stale, run `npx gitnexus analyze` in terminal first.

@@ -2,6 +2,15 @@

 本项目采用语义化版本。功能级变化请从 `docs/features/` 按功能编号追溯。

+## 0.0.2 - 2026-08-12
+
+- 配置仅作用于本项目的 Gitea 远程仓库和凭据隔离策略。
+- 明确密码不入文档、不入配置、不入 Git 历史，以及推送需再次获得用户明确授权。
+
+## 0.0.1 - 2026-08-12
+
+- 增加 PRD 与开发后 Review 强制门禁。
+
 ## 0.0.0 - 2026-08-12

 - 建立工程治理、GitNexus 门禁和功能档案体系。
@@ -28,4 +28,11 @@ The first implementation slice is the market overview screen in `web/`.
 npm run governance:start -- FEAT-MO-001 market-overview
 ```

-当前只使用本地 Git。Gitea 安装完成后再按治理文档配置远程仓库。
+## 项目仓库
+
+- Gitea：<https://git.foximao.com/FoXiMao/a-share-analysis>
+- 远程名：`origin`
+- 配置范围：仅当前项目的 `.git/config`，不修改 Git 全局配置。
+
+凭据不写入仓库、文档或远程 URL。首次需要认证时由 Git 调用 macOS Keychain
+安全保存；详细规则见 [Git 与 Gitea 规范](docs/governance/version-control-and-gitea.md)。
@@ -1 +1 @@
-0.0.0
+0.0.2
@@ -5,6 +5,7 @@ status: approved
 owner: project
 created_at: 2026-08-12
 requirements: requirements.md
+prd: prd.md
 design: design.md
 implementation_plan: implementation-plan.md
 traceability_note: 开发尚未开始，GitNexus与QA证据将在开发门禁执行时创建
@@ -0,0 +1,94 @@
+# 市场综合概览 PRD
+
+- 功能编号：FEAT-MO-001
+- PRD版本：0.1
+- 状态：approved
+- 日期：2026-08-12
+
+## 背景与问题
+
+现有概念稿能够展示指数、情绪、板块和资金数据，但更接近数据看板，用户难以快速回答“市场当前强弱、量能是否支持、行情由谁驱动、风险在哪里”。
+
+## 目标用户与使用场景
+
+主要用户为产品所有者，少量朋友可以使用同一只读工具。用户在盘中以分钟级数据观察全市场状态，在收盘后查看冻结的最终总结和历史交易日结果。
+
+## 产品目标
+
+- 用户进入市场概览后，优先看到一句市场定性以及驱动、风险两列摘要。
+- 用户能够继续核对指数、市场宽度、量能、板块、情绪和资金证据。
+- 用户能够在综合、短线和中长线视角间临时切换，并选择规则、AI、混合或对照分析。
+- 所有实时性、数据日期和分析依据均明确可见。
+
+## 非目标
+
+- 不做自选股、持仓、笔记、交易计划、社区、荐股、跟单和公开组合。
+- 本切片不接正式行情源、RabbitMQ、MySQL、Redis和付费 AI。
+- 本切片不实现用户、邀请、会员、订阅和支付。
+- ETF监控、两融数据、大盘云图和实时消息仍是独立一级模块。
+
+## 用户流程
+
+1. 用户进入“市场概览”。
+2. 首先读取市场定性、驱动因素和风险信号。
+3. 通过“查看依据”核对指标来源。
+4. 向下查看指数、宽度、量能、板块、情绪和资金摘要。
+5. 点击轻量分析状态入口，临时切换分析周期和分析引擎。
+6. 点击指数或板块入口进入未来的详情页；首个切片只保留可识别入口。
+
+## 功能需求
+
+| 编号 | 优先级 | 需求 | 可观察结果 |
+|---|---|---|---|
+| FR-001 | P0 | 结论优先展示市场定性 | 首屏顶部出现一句结论、市场状态、量能状态和情绪状态 |
+| FR-002 | P0 | 展示驱动与风险 | 结论下方并列显示至少三条驱动和三条风险证据 |
+| FR-003 | P0 | 展示数据新鲜度 | 页面显示交易状态、数据更新时间和正常/延迟/不完整状态 |
+| FR-004 | P0 | 提供分析偏好 | 可选择综合/短线/中长线和规则/AI/混合/对照，并在本地保存默认值 |
+| FR-005 | P1 | 展示市场证据模块 | 指数、宽度、量能、板块、情绪和资金摘要可阅读 |
+| FR-006 | P1 | 查看结论依据 | 点击入口后展示指标、数值、口径和更新时间 |
+| FR-007 | P1 | 支持异常状态 | 加载、空、部分数据、过期和错误状态具有明确文案 |
+
+## 数据与口径
+
+首个切片使用确定性模拟快照。字段仍必须包含交易日期、快照时间、来源状态、完整性和单位，以便以后无结构变更地替换为后端 API。
+
+A 股使用红涨绿跌。成交额统一展示为亿元，比例明确使用百分比。历史数据和低频资金数据必须显示实际数据日期，旧数据不得标记为实时。
+
+## 状态与异常
+
+- 交易中：显示分钟级更新时间。
+- 午间休市或已收盘：显示对应市场状态。
+- 数据延迟：保留最近有效值并标记延迟。
+- 部分数据：只隐藏缺失指标，不让整页失败。
+- AI不可用：规则分析继续可用，并标记降级。
+
+## 权限、合规与安全
+
+当前为只读访问，不提供交易指令。结论不得包含买入、卖出、目标价和仓位建议。付费 AI 密钥未来只保存在服务端。
+
+## 成功指标
+
+- 用户能够在 30 秒内说出市场定性、主要驱动和首要风险。
+- 所有结论均能展开查看至少一项数据依据。
+- 页面在目标桌面视口和窄窗口中不阻断核心内容。
+
+## 验收标准
+
+- Given 页面加载有效快照，When 用户进入市场概览，Then 结论、驱动、风险和更新时间在首屏可见。
+- Given 用户打开分析状态入口，When 切换周期或引擎，Then 页面状态立即更新且可选择设为默认。
+- Given 数据快照被标记为延迟，When 页面渲染，Then 最近有效值保留并明确显示延迟，不能显示“实时”。
+- Given 用户点击查看依据，When 抽屉打开，Then 能看到指标名称、数值、口径和更新时间。
+
+## 风险与依赖
+
+- 免费数据源稳定性和商业授权需要在正式接入阶段重新评估。
+- AI 分析必须受结构化数据和规则事实约束。
+- 首个视觉版本用于验证信息层级，不作为最终设计冻结版本。
+
+## 发布范围与回退触发条件
+
+本次仅发布本地 Vue 3 首屏原型。核心交互不可用、结论依据不可追溯或窄屏遮挡核心信息时不得发布；出现回归时回退到上一个本地标签。
+
+## 变更记录
+
+- 0.1：建立首版 PRD，补充结论优先、分析偏好和异常状态。
@@ -5,6 +5,7 @@ status: released
 owner: project
 created_at: 2026-08-12
 requirements: requirements.md
+prd: prd.md
 design: design.md
 implementation_plan: implementation-plan.md
 decisions:
@@ -13,6 +14,8 @@ decisions:
 gitnexus_before: gitnexus/before.md
 gitnexus_after: gitnexus/after.md
 gitnexus_comparison: gitnexus/comparison.md
+code_review: review/code-review.md
+standards_review: review/standards-review.md
 baseline_commit: 7cc2ba0
 implementation_commit: efdfb33
 release: v0.0.0
@@ -0,0 +1,26 @@
+# 工程治理基线 PRD（追补）
+
+- 功能编号：GOV-001
+- PRD版本：0.1
+- 状态：retrospective
+- 日期：2026-08-12
+
+## 背景与目标
+
+该治理功能早于 PRD 强制门禁发布。本文件用于追补当时已经确认的产品目标：所有开发步骤可阅读、可比较、可追溯、可回退，并由 GitNexus在开发前后总结影响。
+
+## 使用者
+
+项目所有者、后续开发者和开发代理。
+
+## 核心需求
+
+- 分离代码开发规范和开发流程规范。
+- 要求关键代码写有信息价值的中文注释。
+- 禁止过度拆分代码。
+- 使用中文提交。
+- 不使用 GitHub，未来接入自建 Gitea。
+
+## 验收结果
+
+上述内容已在 `v0.0.0` 建立。GOV-002 将 PRD 和 Review补充为后续功能的强制门禁。
@@ -0,0 +1,8 @@
+# 代码 Review（追补）
+
+- reviewer_type：self
+- 审查范围：GOV-001 治理脚本与测试
+
+最终结论：passed
+
+治理脚本具有功能编号、路径和必备材料的行为测试；开发前后命令使用参数数组调用外部进程，未拼接用户输入到 Shell。GOV-002 继续增加 PRD 和 Review材料校验。
@@ -0,0 +1,7 @@
+# 开发规范符合性 Review（追补）
+
+- reviewer_type：self
+
+最终结论：passed
+
+GOV-001 已满足当时生效的 GitNexus 双门禁、中文提交、关键中文注释、文档追溯和本地 Git 约束。PRD 与独立 Review要求从 GOV-002 起正式生效，本文件明确标记为追补材料，不伪装成发布前独立审查。
@@ -0,0 +1,5 @@
+# 设计
+
+PRD 与工程需求分离：PRD 定义产品问题、用户、范围和验收；`requirements.md`定义实现约束。Review 分为代码质量和规范符合性两条门禁，两者都必须给出明确状态。
+
+为了适合个人项目，允许结构化自审，但必须诚实标记审查者类型；未来经用户授权可使用独立代理或人工审查。
@@ -0,0 +1,11 @@
+# GitNexus 开发后基线
+
+- 日期：2026-08-12
+- 开发前基线提交：`40f3b2e`
+- 已索引实现提交：`fb4383f`
+- 图谱：300 个符号、325 条关系、5 个功能簇、0 条执行流程
+- 状态：最新
+
+新增 `getUnpassedReviewFiles` 符号只有 `finish.mjs` 一个直接生产依赖，受影响流程为 0，风险为低。
+
+实现提交后再次执行变更检测，结果为 `No changes detected.`。
@@ -0,0 +1,26 @@
+# GitNexus 开发前基线
+
+- 功能编号：GOV-002
+- 记录时间：2026年8月12日 GMT+8 18:20:46
+- 分支：main
+- 基线提交：40f3b2ef6f3b
+
+## 工作区
+
+```text
+(干净)
+```
+
+## GitNexus 状态
+
+```text
+Repository: /Users/citrons/Documents/Codex/2026-08-12/wo-x/a-share-analysis
+Indexed: 8/12/2026, 6:19:51 PM
+Indexed commit: 40f3b2e
+Current commit: 40f3b2e
+Status: ✅ up-to-date
+```
+
+## 后续人工分析
+
+在修改代码前，将 GitNexus query、context、impact 的结论写入 `gitnexus/impact-plan.md`。高风险结果必须先获得用户确认。
@@ -0,0 +1,10 @@
+# GitNexus 前后比较
+
+| 项目 | 开发前 | 开发后 | 变化 |
+|---|---:|---:|---:|
+| 符号 | 171 | 300 | +129 |
+| 关系 | 192 | 325 | +133 |
+| 功能簇 | 4 | 5 | +1 |
+| 执行流程 | 0 | 0 | 0 |
+
+增长主要来自正式市场概览 PRD、PRD/Review规范、模板和 GOV-002 功能档案。实际暂存变更影响为低，没有计划外业务流程。
@@ -0,0 +1,10 @@
+# 实际变更检测
+
+```text
+npx gitnexus detect-changes --repo a-share-analysis --scope staged
+Changes: 38 files, 114 symbols
+Affected processes: 0
+Risk level: low
+```
+
+变更集中在 PRD、Review规范与模板、现有功能档案和治理完成门禁。没有业务页面、API、数据库、RabbitMQ消息或部署配置变化。
@@ -0,0 +1,8 @@
+# GitNexus 开发前影响计划
+
+- 目标符号：`getRequiredFeatureFiles`。
+- 直接依赖：`tools/governance/finish.mjs`。
+- 受影响流程：0。
+- GitNexus风险：低。
+
+预期影响是完成门禁新增三份必备材料，不改变开发前索引、业务代码、API、数据库或界面行为。
@@ -0,0 +1,9 @@
+# 实施计划
+
+1. 执行开发前 GitNexus 索引、查询和影响分析。
+2. 先修改测试，让缺少 PRD 与 Review清单时失败。
+3. 更新完成门禁清单使测试通过。
+4. 新增 PRD、Review规范和模板。
+5. 更新现有治理文档与市场概览功能档案。
+6. 执行测试、GitNexus开发后分析和两类 Review。
+7. 使用中文提交并建立本地补丁版本标签。
@@ -0,0 +1,17 @@
+id: GOV-002
+name: PRD 与 Review 门禁
+slug: prd-review-gates
+status: released
+owner: project
+created_at: 2026-08-12
+prd: prd.md
+requirements: requirements.md
+design: design.md
+implementation_plan: implementation-plan.md
+gitnexus_before: gitnexus/before.md
+gitnexus_after: gitnexus/after.md
+gitnexus_comparison: gitnexus/comparison.md
+code_review: review/code-review.md
+standards_review: review/standards-review.md
+implementation_commit: fb4383f
+release: v0.0.1
@@ -0,0 +1,26 @@
+# PRD 与 Review 门禁 PRD
+
+- 功能编号：GOV-002
+- PRD版本：0.1
+- 状态：approved
+- 日期：2026-08-12
+
+## 问题
+
+现有档案只有工程需求，没有独立 PRD；开发完成后也没有正式 Review环节，无法证明实现符合产品目标和开发规范。
+
+## 目标
+
+- 每个功能必须有可测试、可版本化的 PRD。
+- 每个功能发布前必须完成代码 Review 和开发规范符合性 Review。
+- 完成门禁自动检查三份材料存在且非空。
+
+## 非目标
+
+本功能不接入外部代码审查平台，不配置 Gitea远程，也不修改业务功能。
+
+## 验收标准
+
+- 完成门禁清单包含 `prd.md`、`review/code-review.md` 和 `review/standards-review.md`。
+- 市场概览具有正式 PRD。
+- 流程文档明确 Review 不通过时的回流路径。
@@ -0,0 +1,14 @@
+# 测试结果
+
+## 测试先行证据
+
+1. 必备文件清单测试先因缺少 `prd.md` 和两类 Review失败。
+2. 更新清单后，4 个原有测试通过。
+3. 新增 Review状态测试先因 `getUnpassedReviewFiles` 不存在而失败。
+4. 实现固定最终结论校验后，5 个测试通过。
+
+## 门禁行为
+
+`pending` Review执行 `npm run governance:finish -- GOV-002 prd-review-gates` 时退出码为 1，并准确列出两份未通过报告。
+
+两份 Review 改为明确 `passed` 后，同一完成门禁执行成功。最终治理测试为 5 个通过、0 个失败。
@@ -0,0 +1,3 @@
+# 视觉 QA
+
+本功能不修改用户界面，视觉 QA 不适用。
@@ -0,0 +1,10 @@
+# 发布说明
+
+## v0.0.1
+
+新增 PRD 事实来源与开发后双 Review 发布门禁，不改变业务功能。
+
+- 实现提交：`fb4383f`。
+- 功能档案强制包含 PRD、代码 Review 和规范符合性 Review。
+- 完成门禁拒绝 `pending`、`blocked` 和 `changes_required` Review。
+- 为市场综合概览补充正式 PRD。
@@ -0,0 +1,7 @@
+# 工程需求
+
+- 更新功能档案必备文件清单。
+- 为新增清单先写失败测试并完成红—绿验证。
+- 提供 PRD 与两类 Review 的规范和模板。
+- 更新 AGENTS、开发流程、代码规范和追溯目录。
+- 对 GOV-001明确追补状态，对 FEAT-MO-001补充正式 PRD。
@@ -0,0 +1,29 @@
+# 代码 Review
+
+- reviewer_type：self
+- reviewer：Codex
+- 基线提交：`40f3b2e`
+- 实现提交：`fb4383f`
+- 审查范围：治理必备文件清单、Review完成门禁、PRD与Review规范
+- 日期：2026-08-12
+
+## PRD 与设计符合性
+
+实现覆盖 PRD 的三项验收：必备清单加入 PRD和两类Review；市场概览新增正式PRD；开发流程加入Review回流和发布门禁。
+
+## 发现与处置
+
+| 严重程度 | 发现 | 处置 |
+|---|---|---|
+| Important | 最初只检查 Review 文件非空，`pending` 报告也可能通过 | 新增 `getUnpassedReviewFiles`，要求两份报告都包含固定最终结论 `passed` |
+| Important | 新门禁行为缺少回归测试 | 先写失败测试，确认缺少导出时失败，再实现并验证通过 |
+| Minor | 当前是实现者自审，不具备独立审查视角 | 诚实标记 `reviewer_type: self`；未来用户授权多代理或有其他开发者时优先独立审查 |
+
+## 验证
+
+- 5 个治理测试通过。
+- `pending` Review 的完成门禁以退出码 1 失败，并列出两份未通过报告。
+- GitNexus 对新增 Review校验的上游影响为 1 个直接依赖、0 个流程，风险为低。
+- 完整暂存区变更检测为 38 个文件、114 个符号、0 条流程，风险为低。
+
+最终结论：passed
@@ -0,0 +1,23 @@
+# 开发规范符合性 Review
+
+- reviewer_type：self
+- reviewer：Codex
+- 实现提交：`fb4383f`
+- 日期：2026-08-12
+
+## 检查结果
+
+- [x] 新增公共函数包含解释门禁原因的中文注释。
+- [x] 校验逻辑保留在现有 `feature-record.mjs`，没有为单个判断过度拆分文件。
+- [x] 命名明确区分必备文件和未通过 Review。
+- [x] Review结论采用固定机器可读行，错误信息列出具体文件。
+- [x] 新行为有测试先行的红—绿证据。
+- [x] GitNexus开发前索引、查询、上下文和影响分析已经执行。
+- [x] PRD、工程需求、设计、测试计划和回退说明一致。
+- [x] 未配置 GitHub 或其他远程仓库。
+
+## 不符合项与处置
+
+没有未解决的 Critical 或 Important 不符合项。独立审查缺失属于个人项目当前限制，已经在代码 Review中透明记录。
+
+最终结论：passed
@@ -0,0 +1,3 @@
+# 回退说明
+
+本功能只增加文档和完成门禁清单。若门禁实现异常，使用修复提交恢复；确需回退时检出 `v0.0.0` 可获得升级前治理基线。
@@ -0,0 +1,6 @@
+# 测试计划
+
+- 证明旧清单缺少三份材料时测试失败。
+- 证明新清单精确包含 PRD 与两类 Review。
+- 完成门禁在任一材料缺失或为空时失败。
+- 文档占位符、脚本语法、中文提交和远程仓库状态通过检查。
@@ -0,0 +1,17 @@
+# 设计
+
+## 配置边界
+
+Git 仓库级配置存放在本项目 `.git/config`，天然不被提交，也不会作用于同一台机器上的其他项目。远程 URL 只包含协议、主机、所有者与仓库名，不嵌入用户名密码。
+
+## 凭据处理
+
+选择 macOS 原生 `osxkeychain` 凭据助手，避免明文凭据。设置 `credential.useHttpPath=true`，使 `git.foximao.com` 下不同仓库可以按 URL 路径隔离凭据；项目账号作为非敏感标识保存在本地仓库配置和治理文档中。
+
+## 授权边界
+
+远程接入分为两种权限：只读检查属于本次配置验证；推送会改变外部状态，需要用户另行明确授权。因此本次只执行非交互 `ls-remote`，不推送 `main` 或标签。
+
+## 文档边界
+
+文档记录可复现配置，但只引用密码的安全管理规则，不记录密码本身。这样既满足项目可追溯性，也避免秘密随克隆、备份和历史版本扩散。
@@ -0,0 +1,10 @@
+# GitNexus 开发后结果
+
+- 执行：`npx gitnexus analyze`。
+- 提交前工作区索引：349 个节点、375 条关系、5 个集群、0 条执行流程。
+- 提交后最终索引：361 个节点、387 条关系、5 个集群、0 条执行流程。
+- 最终增量分析：4 个已修改文件、0 个新增文件、0 个删除文件；其余 77 个文件行复用既有索引。
+- 索引提交：`b69023e`。
+- 状态：up-to-date。
+
+本功能没有修改生产代码、函数调用关系或业务流程。新增节点主要来自 GOV-003 功能档案和版本控制文档标题。提交后再次分析用于把索引锚定到确定提交，而不是只保留工作区快照。
@@ -0,0 +1,26 @@
+# GitNexus 开发前基线
+
+- 功能编号：GOV-003
+- 记录时间：2026年8月12日 GMT+8 18:28:00
+- 分支：main
+- 基线提交：7c7190998b6d
+
+## 工作区
+
+```text
+(干净)
+```
+
+## GitNexus 状态
+
+```text
+Repository: /Users/citrons/Documents/Codex/2026-08-12/wo-x/a-share-analysis
+Indexed: 8/12/2026, 6:27:10 PM
+Indexed commit: 7c71909
+Current commit: 7c71909
+Status: ✅ up-to-date
+```
+
+## 后续人工分析
+
+在修改代码前，将 GitNexus query、context、impact 的结论写入 `gitnexus/impact-plan.md`。高风险结果必须先获得用户确认。
@@ -0,0 +1,10 @@
+# GitNexus 前后对比
+
+| 项目 | 开发前 | 开发后 | 变化 |
+|---|---:|---:|---:|
+| 节点 | 301 | 361 | +60 |
+| 关系 | 326 | 387 | +61 |
+| 集群 | 5 | 5 | 0 |
+| 执行流程 | 0 | 0 | 0 |
+
+节点和关系增长来自 Gitea 治理说明及完整功能档案；没有新增或改变业务执行流程。变更检测风险为低，与开发前影响预估一致。最终索引已锚定实现提交 `b69023e`。
@@ -0,0 +1,8 @@
+# GitNexus 变更检测
+
+- 命令：`npx gitnexus detect-changes --repo a-share-analysis --scope all`。
+- 最终暂存区识别范围：24 个文件、51 个文档符号。
+- 受影响流程：0。
+- 风险等级：低。
+
+初次对未暂存变化检测到 7 个既有文件、14 个符号；完整暂存后，GOV-003 新建档案也被纳入检测，最终扩大为 24 个文件、51 个符号。纯文本版本文件和 Changelog 另外通过 `git status`、`git diff --stat` 和完整必备文件门禁核对。
@@ -0,0 +1,8 @@
+# GitNexus 开发前影响分析
+
+- 查询主题：`Gitea local remote version control configuration`。
+- 主要关联：`docs/governance/version-control-and-gitea.md`、`docs/index.md`、`VERSION`、`AGENTS.md` 和 `README.md`。
+- 符号影响检查：`getRequiredFeatureFiles` 只有 1 个直接上游依赖 `finish.mjs`，不参与执行流程，风险为低。
+- 实际变化以文档和 Git 仓库级配置为主，不修改生产代码、API、数据库或前端页面。
+- 预计影响：版本控制入口说明、开发代理约束、版本号和 GOV-003 功能档案。
+- 风险控制：不修改全局配置、不保存密码、不执行推送；修改后重新索引并执行变更检测。
@@ -0,0 +1,10 @@
+# 实施计划
+
+1. 执行开发前 GitNexus 更新、查询和影响分析。
+2. 核对当前远程、本地配置和全局配置基线。
+3. 添加 `origin`，使用 `--local` 设置凭据隔离和默认推送目标。
+4. 通过非交互 `git ls-remote origin` 验证只读连通性。
+5. 更新版本控制规范、代理约束、README、文档索引与版本记录。
+6. 保存 PRD、设计、测试、GitNexus 前后对比和回退说明。
+7. 执行治理测试、敏感信息检查、配置边界检查和双 Review。
+8. 以中文提交封存，并建立本地 `v0.0.2` 标签；不推送。
@@ -0,0 +1,17 @@
+id: GOV-003
+name: 项目专用 Gitea 远程仓库
+slug: gitea-local-remote
+status: released
+owner: project
+created_at: 2026-08-12
+prd: prd.md
+requirements: requirements.md
+design: design.md
+implementation_plan: implementation-plan.md
+gitnexus_before: gitnexus/before.md
+gitnexus_after: gitnexus/after.md
+gitnexus_comparison: gitnexus/comparison.md
+code_review: review/code-review.md
+standards_review: review/standards-review.md
+implementation_commit: b69023e
+release: v0.0.2
@@ -0,0 +1,37 @@
+# 项目专用 Gitea 远程仓库 PRD
+
+- 功能编号：GOV-003
+- PRD 版本：0.1
+- 状态：approved
+- 日期：2026-08-12
+
+## 问题
+
+项目已有可追溯的本地 Git 基线，但尚未关联用户自建 Gitea。接入过程中必须避免把项目凭据扩散到其他仓库，或把密码写入可提交文件和 Git 历史。
+
+## 目标
+
+- 将当前项目的 `origin` 指向指定 Gitea 仓库。
+- 所有 Git 设置只作用于当前项目，不修改全局配置。
+- 使用系统钥匙串保存未来交互式认证产生的凭据，并按仓库路径隔离。
+- 在治理文档中记录地址、账号、配置、验证和回退方法。
+
+## 非目标
+
+- 本次不向远程推送任何提交或标签。
+- 不在项目内保存密码或访问令牌。
+- 不配置 Gitea Actions、Webhook、分支保护或持续集成服务端规则。
+- 不修改其他项目的 Git 配置。
+
+## 用户流程
+
+项目维护者可以从文档确认唯一远程地址和项目账号；代理和开发者使用项目级配置进行读取。首次获得明确推送授权后，维护者在交互式终端完成认证，凭据由 macOS Keychain 管理。
+
+## 验收标准
+
+- `git remote -v` 的 fetch/push 均为指定仓库。
+- 项目级凭据助手为 `osxkeychain`，`credential.useHttpPath` 为 `true`。
+- 全局凭据助手与默认推送目标保持修改前状态。
+- 无密码进入文档、远程 URL、Git 配置或 Git 历史。
+- `git ls-remote origin` 可以建立只读连接。
+- PRD、设计、测试、Review 和回退档案完整。
@@ -0,0 +1,20 @@
+# 测试结果
+
+## 结果摘要
+
+- `npm run test:governance`：5 个测试通过，0 个失败。
+- `GIT_TERMINAL_PROMPT=0 git ls-remote origin`：退出码 0；远程是空仓库，返回引用为空。
+- fetch 与 push URL：均精确匹配指定 Gitea 仓库。
+- 项目级配置：`osxkeychain`、路径隔离、账号和默认推送目标全部匹配设计。
+- 全局边界：全局 `credential.helper` 和 `remote.pushDefault` 仍未设置。
+- 凭据模式扫描：未发现带用户名密码的 URL、密码赋值或令牌赋值。
+- `git diff --check`：通过。
+
+## 诊断与修正
+
+1. 测试计划最初写成不存在的 `npm test`，执行时因缺少脚本失败；检查 `package.json` 后修正为项目实际提供的 `npm run test:governance`，复测通过。
+2. GitNexus 变更检测最初未指定仓库；本机存在多个索引时工具拒绝猜测。增加 `--repo a-share-analysis` 后成功；最终暂存区结果为 24 个文件、51 个符号、0 条流程，风险为低。
+
+## 完成门禁
+
+双 Review 完成后执行 `npm run governance:finish -- GOV-003 gitea-local-remote`，退出码为 0。门禁确认完整功能档案和两份固定 `passed` Review 均已就绪。
@@ -0,0 +1,3 @@
+# 视觉验证
+
+本功能只修改 Git 仓库级配置和治理文档，不改变界面、样式或交互，因此视觉验证不适用。
@@ -0,0 +1,9 @@
+# 发布说明
+
+## v0.0.2
+
+- 实现提交：`b69023e`。
+- 为当前项目配置指定 Gitea `origin`，不影响其他项目。
+- 使用 macOS Keychain 与仓库路径隔离策略管理未来认证凭据。
+- 增加远程接入、授权边界、验证和回退文档。
+- 本版本只建立远程连接，不推送本地提交或标签。
@@ -0,0 +1,9 @@
+# 工程需求
+
+- 远程名固定为 `origin`，地址固定为 `https://git.foximao.com/FoXiMao/a-share-analysis.git`。
+- 使用 `git config --local` 写入凭据助手、路径隔离、账号和默认推送目标。
+- 不调用 `git config --global`，验证前后全局相关配置一致。
+- 不将密码传给 Shell 命令，也不把密码写入仓库文件或 `.git/config`。
+- 使用非交互、只读的 `git ls-remote origin` 检查网络与仓库可达性。
+- 未取得单独明确授权时，不运行 `git push`。
+- 更新根目录入口、治理规范、文档索引、版本和完整功能档案。
@@ -0,0 +1,31 @@
+# 配置与文档 Review
+
+- reviewer_type：self
+- reviewer：Codex
+- 基线提交：`7c71909`
+- 实现提交：`b69023e`
+- 审查范围：项目级 Gitea 远程、凭据隔离、治理文档和回退方案
+- 日期：2026-08-12
+
+## PRD 与设计符合性
+
+实现满足六项验收标准：远程 URL 正确；凭据设置仅位于 `.git/config`；全局配置未变化；密码没有进入文档、配置或历史；只读连通性成功；功能档案完整。
+
+## 发现与处置
+
+| 严重程度 | 发现 | 处置 |
+|---|---|---|
+| Important | 用户提供了密码，但写入文档或命令会形成长期泄露面 | 文档只保存基础地址、账号和仓库 URL；密码不落盘，由 Keychain 在未来交互认证时接管 |
+| Important | 使用全局凭据配置会影响其他项目 | 全部使用 `git config --local`，并验证相关全局项保持未设置 |
+| Minor | 初始测试计划引用了不存在的 `npm test` | 改用仓库实际的 `npm run test:governance` 并复测 5/5 通过 |
+| Minor | GitNexus 多仓库环境无法自动选择索引 | 显式增加 `--repo a-share-analysis`，变更检测成功 |
+
+## 验证
+
+- 远程只读连接、fetch/push URL 和四项本地配置断言全部通过。
+- 全局配置边界断言通过。
+- 凭据模式扫描与 `git diff --check` 通过。
+- GitNexus 最终暂存区检测 24 个文件、51 个符号、0 条流程，风险为低。
+- 没有执行 `git push`，未改变 Gitea 远程仓库内容。
+
+最终结论：passed
@@ -0,0 +1,24 @@
+# 开发规范符合性 Review
+
+- reviewer_type：self
+- reviewer：Codex
+- 实现提交：`b69023e`
+- 日期：2026-08-12
+
+## 检查结果
+
+- [x] 开发前执行治理启动命令并保存 GitNexus 基线。
+- [x] PRD、工程需求、设计、实施计划、测试计划和回退说明一致。
+- [x] 修改仅涉及项目级 Git 配置和治理文档，没有过度拆分生产代码。
+- [x] 基础地址、账号和仓库 URL 可追溯，密码和令牌未进入仓库。
+- [x] Git 全局配置没有修改，不影响其他项目。
+- [x] 未配置 GitHub，唯一远程为用户指定 Gitea。
+- [x] 没有未经授权推送外部状态。
+- [x] 治理测试、配置断言、敏感信息扫描和 GitNexus 变更检测通过。
+- [x] 本功能无界面变化，视觉验证已合理标记为不适用。
+
+## 不符合项与处置
+
+没有未解决的 Critical 或 Important 不符合项。两项执行期错误均属于测试命令选择问题，已修正文档并以成功复测关闭。
+
+最终结论：passed
@@ -0,0 +1,13 @@
+# 回退说明
+
+本功能的运行时影响仅限当前项目 `.git/config`。如需解除接入，在本项目根目录执行：
+
+```bash
+git remote remove origin
+git config --local --unset credential.helper
+git config --local --unset credential.useHttpPath
+git config --local --unset credential.username
+git config --local --unset remote.pushDefault
+```
+
+若 Keychain 已在后续交互式认证中保存凭据，再使用“钥匙串访问”按 `git.foximao.com` 删除对应项。文档和版本记录通过新的中文修复提交回退；不得改写已共享历史。本次未执行推送，因此远程不存在需要回滚的外部提交。
@@ -0,0 +1,9 @@
+# 测试计划
+
+- 检查 `origin` 的 fetch/push URL 精确匹配指定仓库。
+- 检查四项 Git 配置来自 `--local` 作用域。
+- 检查全局凭据助手和默认推送目标仍保持未设置。
+- 使用 `GIT_TERMINAL_PROMPT=0 git ls-remote origin` 验证远程只读连通性。
+- 搜索仓库文件、暂存区 diff 和远程 URL，确认不存在密码或凭据 URL。
+- 运行 `npm run test:governance` 和 `npm run governance:finish -- GOV-003 gitea-local-remote`。
+- 本功能不改变页面，视觉验证标记为不适用并说明原因。
@@ -113,3 +113,16 @@ count += 1;
 - AI 密钥、数据源凭证和支付凭证仅存在服务端密钥管理中。
 - SQL必须参数化；外部输入必须在边界处校验。
 - 日志和异常报告必须脱敏。
+
+## 12. 代码 Review 要求
+
+开发者完成自测不等于 Review 完成。审查者必须从功能 PRD、设计和 Git diff 出发，检查：
+
+- 业务行为是否真正满足验收标准，是否存在遗漏分支。
+- 类型、数据口径、缓存、消息、事务和异常恢复是否正确。
+- 是否引入安全、性能、并发、幂等或数据一致性风险。
+- 测试是否能捕获真实回归，而非只验证 Mock 或实现细节。
+- 中文注释是否解释关键原因、口径和限制，是否存在失真注释。
+- 文件拆分是否便于常规阅读，是否出现过度抽象或巨型多职责文件。
+
+Critical 和 Important 问题必须修复并复审。Minor 问题可以延期，但必须写明理由和后续功能编号。
@@ -7,7 +7,7 @@
 ## 2. 功能状态

 ```text
-proposed → designing → approved → developing → verifying → released
+proposed → prd_review → designing → approved → developing → verifying → reviewing → released
                                      ↘ blocked
 released → superseded
 ```
@@ -18,18 +18,19 @@ released → superseded

 1. 分配功能编号和英文短名称。
 2. 建立 `docs/features/<编号>-<短名称>/`。
-3. 填写需求、范围、非目标和验收标准。
-4. 比较可选方案，记录设计与关键决策。
-5. 更新 API、事件和数据结构契约。
-6. 编写测试计划和实施计划。
-7. 确保 Git 工作区基线可识别，执行：
+3. 编写 `prd.md`，明确用户问题、目标、范围、非目标、用户流程、指标、风险和验收标准。
+4. PRD 审核通过后，将产品需求转换为可测试的工程需求。
+5. 比较可选方案，记录设计与关键决策。
+6. 更新 API、事件和数据结构契约。
+7. 编写测试计划和实施计划。
+8. 确保 Git 工作区基线可识别，执行：

 ```bash
 npm run governance:start -- FEAT-MO-001 market-overview
 ```

-8. 运行 GitNexus 查询、上下文和影响分析，将结果写入 `gitnexus/impact-plan.md`。
-9. 高风险或关键路径变化必须先向用户说明影响，再进入开发。
+9. 运行 GitNexus 查询、上下文和影响分析，将结果写入 `gitnexus/impact-plan.md`。
+10. 高风险或关键路径变化必须先向用户说明影响，再进入开发。

 开发前必须至少回答：修改什么、为什么修改、影响谁、如何验证、失败后如何回退。

@@ -54,9 +55,13 @@ npm run governance:finish -- FEAT-MO-001 market-overview
 ```

 6. 填写 `gitnexus/after.md`、`detected-changes.md` 和 `comparison.md`。
-7. 更新发布说明、回退说明、变更记录和版本号。
-8. 使用中文 Conventional Commit提交。
-9. 提交后执行 `npx gitnexus status`；若状态过期，再运行 `npx gitnexus analyze`。
+7. 执行代码 Review，将问题、严重程度、修复提交和复审结论写入 `review/code-review.md`。
+8. 逐条执行开发规范符合性 Review，将结果写入 `review/standards-review.md`。
+9. 任一 Review 为 `changes_required` 时，返回开发阶段；修复后重跑相关测试、GitNexus开发后分析和 Review。
+10. 两项 Review 均为 `passed` 后，更新发布说明、回退说明、变更记录和版本号。
+11. 使用中文 Conventional Commit提交。
+12. 提交后执行 `npx gitnexus status`；若状态过期，再运行 `npx gitnexus analyze`。
+13. 本地提交和标签完成后仍不得自动推送；只有用户明确要求时，才向项目专用 Gitea `origin` 推送。

 ## 6. 完成定义

@@ -68,6 +73,8 @@ npm run governance:finish -- FEAT-MO-001 market-overview
 - 测试和构建有最新成功证据。
 - 视觉变化有同视口对比证据。
 - GitNexus 开发前后报告和差异说明齐全。
+- 代码 Review 结论为 `passed`，Critical 和 Important 问题已关闭。
+- 开发规范符合性 Review 结论为 `passed`。
 - 发布说明和回退方法可执行。
 - 中文提交已关联功能编号。

@@ -9,6 +9,7 @@
 ```text
 docs/features/<编号>-<短名称>/
 ├── manifest.yaml
+├── prd.md
 ├── requirements.md
 ├── design.md
 ├── implementation-plan.md
@@ -26,6 +27,9 @@ docs/features/<编号>-<短名称>/
 ├── qa/
 │   ├── test-results.md
 │   └── visual-qa.md
+├── review/
+│   ├── code-review.md
+│   └── standards-review.md
 ├── release-notes.md
 └── rollback.md
 ```
@@ -33,6 +37,8 @@ docs/features/<编号>-<短名称>/
 ## 3. 历史保留

 - 已发布文档不删除、不覆盖历史结论；修订通过 Git 历史和文档版本说明保留。
+- PRD 是产品目标和验收口径的正式来源；`requirements.md` 是从 PRD 派生的工程约束，二者不能相互替代。
+- Review 文件必须记录审查范围、基线提交、审查提交、发现、处置和最终结论，禁止只写“看过了”。
 - 重大方案变化新增 ADR，旧 ADR 标记被替代。
 - 规则、提示词、API 和事件契约使用明确版本。
 - 截图文件名包含页面、状态、视口和版本，例如 `market-overview-trading-1440x1200-v0.1.0.png`。
@@ -0,0 +1,34 @@
+# PRD 编写规范
+
+## 1. 定位
+
+PRD 是每个业务功能的产品需求事实来源，回答“为谁解决什么问题、为什么做、做到什么程度算完成”。技术设计回答“如何实现”，不能替代 PRD。
+
+治理、重构和纯技术任务也需要简化 PRD，用于说明使用者、治理问题、目标和完成标准。
+
+## 2. 必备章节
+
+每份 `prd.md` 至少包含：
+
+1. 文档信息：功能编号、版本、状态、作者、日期。
+2. 背景与问题：当前状态、具体问题和证据。
+3. 目标用户与场景：谁在什么时点使用。
+4. 产品目标：用户能够完成什么，产品改善什么。
+5. 非目标：本期明确不解决什么。
+6. 用户流程：入口、关键步骤、结果和异常路径。
+7. 功能需求：编号、优先级、行为与可观察结果。
+8. 数据与口径：来源、时效、单位、缺失和过期处理。
+9. 状态与异常：加载、空、部分数据、错误和降级。
+10. 权限与合规：访问边界、隐私、声明和安全限制。
+11. 成功指标：可以观测和验证的产品指标。
+12. 验收标准：使用 Given/When/Then 或等价可测试描述。
+13. 风险与依赖：外部数据、技术、成本和上线依赖。
+14. 发布范围：本次、后续和回退触发条件。
+
+## 3. 编写规则
+
+- 需求使用 `FR-001` 等稳定编号，测试和 Review引用该编号。
+- 禁止用“体验更好”“速度较快”等不可验证表达。
+- UI 布局不是需求本身；应先写用户需要识别和完成的行为。
+- PRD 发生实质变化时更新版本和变更记录，并重新确认设计与测试影响。
+- 已发布 PRD 不删除旧结论，废弃需求标记 `superseded` 并说明替代项。
@@ -0,0 +1,37 @@
+# Review 审查规范
+
+## 1. 两类 Review
+
+### 代码 Review
+
+以 PRD、设计、实施计划、Git diff和测试证据为输入，审查正确性、安全性、性能、数据一致性、契约兼容性和测试充分性。
+
+### 开发规范符合性 Review
+
+逐条检查代码开发规范和流程规范，包括中文注释、命名、文件拆分尺度、日志、错误处理、GitNexus前后门禁、中文提交、文档和回退材料。
+
+## 2. 审查角色
+
+- 优先由非实现者进行独立 Review。
+- 个人项目没有独立审查者时，可以执行结构化自审，但必须在报告中标明 `reviewer_type: self`，不得伪称独立审查。
+- 使用代理审查时，必须提供功能说明、PRD、设计、基线 SHA 和当前 SHA；只有用户明确授权多代理时才调用独立审查代理。
+
+## 3. 严重程度
+
+- Critical：可能导致数据错误、安全事故、核心功能不可用或不可恢复，必须修复。
+- Important：会造成明显错误、回归、规范失效或重要测试缺口，必须修复。
+- Minor：不阻塞当前功能，但应记录后续处理或接受理由。
+
+## 4. 结论
+
+Review 只能使用：
+
+- `passed`：没有未解决的 Critical 或 Important，证据齐全。
+- `changes_required`：存在必须修改的问题。
+- `blocked`：缺少 PRD、代码、测试、环境或其他必要证据。
+
+修复 Review 问题后必须记录修复提交和复审结论。代码变化会使旧的 GitNexus开发后报告失效时，必须重新更新图谱和影响报告。
+
+## 5. 发布门禁
+
+`review/code-review.md` 和 `review/standards-review.md` 均存在、非空且最终结论为 `passed` 后，功能才允许进入发布状态。
@@ -2,7 +2,17 @@

 ## 1. 当前策略

-当前只使用本地 Git，不配置 GitHub、不创建 GitHub Actions，也不向任何第三方远程仓库推送。用户安装 Gitea 后，再显式配置 `origin`。
+本项目使用本地 Git 和用户自建 Gitea，不使用 GitHub，也不创建 GitHub Actions。
+
+| 配置项 | 值 |
+|---|---|
+| Gitea 基础地址 | `https://git.foximao.com/` |
+| 项目账号 | `FoXiMao` |
+| 唯一远程仓库 | `https://git.foximao.com/FoXiMao/a-share-analysis.git` |
+| 远程名 | `origin` |
+| 配置作用域 | 当前项目 `.git/config` |
+
+密码不属于项目文档。它不得出现在仓库文件、Git 历史、远程 URL、脚本或命令参数中；首次认证时由 Git 凭据助手请求，并交由 macOS Keychain 保存。

 ## 2. 分支与提交

@@ -18,18 +28,59 @@
 git config core.hooksPath .githooks
 ```

-## 3. Gitea 接入
+## 3. Gitea 项目级接入

-Gitea 安装并创建空仓库后，由用户确认地址，再执行：
+在本项目根目录执行以下项目级配置：
+
+```bash
+git remote add origin https://git.foximao.com/FoXiMao/a-share-analysis.git
+git config --local credential.helper osxkeychain
+git config --local credential.useHttpPath true
+git config --local credential.username FoXiMao
+git config --local remote.pushDefault origin
+```
+
+`credential.useHttpPath=true` 让同一 Gitea 域名下不同仓库按路径区分凭据；所有设置使用 `--local`，只写入本项目不可提交的 `.git/config`。禁止使用 `git config --global` 配置本项目账号、凭据助手或默认推送目标。
+
+只读连通性检查：
+
+```bash
+GIT_TERMINAL_PROMPT=0 git ls-remote origin
+```
+
+首次需要写权限时，由用户在交互式终端执行推送并输入凭据：

 ```bash
-git remote add origin <用户提供的Gitea仓库地址>
 git push -u origin main
 ```

-建议在 Gitea 中保护 `main`：禁止强推、要求状态检查通过、要求变更说明关联功能编号。未得到用户提供的地址和授权前，任何代理不得自行添加远程或推送。
+添加远程和验证连通性不代表授权自动推送。代理只有在用户明确要求推送时才能执行。建议在 Gitea 中保护 `main`：禁止强推、要求状态检查通过、要求变更说明关联功能编号。

-## 4. 版本与标签
+## 4. 配置检查与移除
+
+检查当前项目和全局配置的边界：
+
+```bash
+git remote -v
+git config --local --get credential.helper
+git config --local --get credential.useHttpPath
+git config --global --get-all credential.helper
+git config --global --get remote.pushDefault
+```
+
+如需解除本项目 Gitea 接入，执行：
+
+```bash
+git remote remove origin
+git config --local --unset credential.helper
+git config --local --unset credential.useHttpPath
+git config --local --unset credential.username
+git config --local --unset remote.pushDefault
+```
+
+上述操作只影响本项目。Keychain 中已保存的凭据需要在“钥匙串访问”中按 `git.foximao.com` 单独删除。
+
+## 5. 版本与标签

 发布使用带注释标签，例如：

@@ -4,6 +4,8 @@

 - [代码开发规范](governance/code-development-standards.md)
 - [开发流程规范](governance/development-workflow.md)
+- [PRD 编写规范](governance/prd-standard.md)
+- [Review 审查规范](governance/review-standard.md)
 - [文档与追溯规范](governance/documentation-traceability.md)
 - [Git 与 Gitea 规范](governance/version-control-and-gitea.md)

@@ -23,5 +25,7 @@

 - [GOV-001：工程治理基线](features/GOV-001-engineering-governance/manifest.yaml)
 - [FEAT-MO-001：市场综合概览](features/FEAT-MO-001-market-overview/manifest.yaml)
+- [GOV-002：PRD 与 Review 门禁](features/GOV-002-prd-review-gates/manifest.yaml)
+- [GOV-003：项目专用 Gitea 远程仓库](features/GOV-003-gitea-local-remote/manifest.yaml)

 功能档案是需求、设计、代码、测试、版本和回退之间的唯一正式关联入口。
@@ -0,0 +1,27 @@
+# 代码 Review
+
+- 功能编号：
+- reviewer_type：self / independent
+- reviewer：
+- 基线提交：
+- 审查提交：
+- 日期：
+
+## 审查范围
+
+## PRD 与设计符合性
+
+## 发现
+
+| 严重程度 | 位置 | 问题 | 影响 | 处理 |
+|---|---|---|---|---|
+
+## 测试缺口
+
+## 修复与复审
+
+## 最终结论
+
+最终结论：blocked
+
+完成审查后，将上行值改为 `passed`、`changes_required` 或 `blocked`。门禁只接受独占一行的 `最终结论：passed`。
@@ -0,0 +1,37 @@
+# <功能名称> PRD
+
+- 功能编号：
+- PRD版本：
+- 状态：draft
+- 日期：
+
+## 背景与问题
+
+## 目标用户与使用场景
+
+## 产品目标
+
+## 非目标
+
+## 用户流程
+
+## 功能需求
+
+| 编号 | 优先级 | 需求 | 可观察结果 |
+|---|---|---|---|
+
+## 数据与口径
+
+## 状态与异常
+
+## 权限、合规与安全
+
+## 成功指标
+
+## 验收标准
+
+## 风险与依赖
+
+## 发布范围与回退触发条件
+
+## 变更记录
@@ -0,0 +1,28 @@
+# 开发规范符合性 Review
+
+- 功能编号：
+- reviewer_type：self / independent
+- reviewer：
+- 审查提交：
+- 日期：
+
+## 检查结果
+
+- [ ] 必要中文注释准确且没有逐行废话注释。
+- [ ] 文件按稳定职责拆分，适合连续阅读，没有过度碎片化。
+- [ ] 命名、类型、单位和时间语义明确。
+- [ ] 错误处理、日志、脱敏和降级符合规范。
+- [ ] API、事件、规则和提示词按需版本化。
+- [ ] 测试先行证据、构建和视觉验证齐全。
+- [ ] GitNexus开发前后报告和实际变更检测齐全。
+- [ ] PRD、设计、发布说明和回退说明一致。
+- [ ] 提交使用中文 Conventional Commit并关联功能编号。
+- [ ] 未使用 GitHub，未擅自配置或推送远程仓库。
+
+## 不符合项与处置
+
+## 最终结论
+
+最终结论：blocked
+
+完成审查后，将上行值改为 `passed`、`changes_required` 或 `blocked`。门禁只接受独占一行的 `最终结论：passed`。
@@ -4,6 +4,7 @@ const FEATURE_ID_PATTERN = /^(?:FEAT-[A-Z]{2,8}|GOV)-\d{3}$/;

 const REQUIRED_FEATURE_FILES = Object.freeze([
  'manifest.yaml',
+  'prd.md',
  'requirements.md',
  'design.md',
  'implementation-plan.md',
@@ -15,10 +16,17 @@ const REQUIRED_FEATURE_FILES = Object.freeze([
  'gitnexus/comparison.md',
  'qa/test-results.md',
  'qa/visual-qa.md',
+  'review/code-review.md',
+  'review/standards-review.md',
  'release-notes.md',
  'rollback.md',
 ]);

+const REVIEW_FILES = Object.freeze([
+  'review/code-review.md',
+  'review/standards-review.md',
+]);
+
 /**
 * 功能编号是需求、设计、代码提交、测试结果和发布记录之间的主关联键。
 * 严格限制格式可以避免路径穿越、临时名称以及后续无法检索的模糊编号。
@@ -49,3 +57,14 @@ export function getFeatureDirectory(repositoryRoot, featureId, slug) {
 export function getRequiredFeatureFiles() {
  return [...REQUIRED_FEATURE_FILES];
 }
+
+/**
+ * Review 报告不能只靠“文件存在”通过门禁。这里要求报告使用固定的最终结论行，
+ * 避免 pending、blocked 或 changes_required 被一段其他说明文字意外判定为通过。
+ */
+export function getUnpassedReviewFiles(reviewReports) {
+  return REVIEW_FILES.filter((file) => {
+    const content = reviewReports.get(file) ?? '';
+    return !/^最终结论：passed$/m.test(content);
+  });
+}
@@ -2,6 +2,7 @@ import assert from 'node:assert/strict';
 import test from 'node:test';

 import {
+  getUnpassedReviewFiles,
  getFeatureDirectory,
  getRequiredFeatureFiles,
  validateFeatureId,
@@ -28,6 +29,7 @@ test('将功能编号和短名称解析到固定的功能档案目录', () => {
 test('返回开发完成前必须存在的完整追溯文件清单', () => {
  assert.deepEqual(getRequiredFeatureFiles(), [
    'manifest.yaml',
+    'prd.md',
    'requirements.md',
    'design.md',
    'implementation-plan.md',
@@ -39,7 +41,26 @@ test('返回开发完成前必须存在的完整追溯文件清单', () => {
    'gitnexus/comparison.md',
    'qa/test-results.md',
    'qa/visual-qa.md',
+    'review/code-review.md',
+    'review/standards-review.md',
    'release-notes.md',
    'rollback.md',
  ]);
 });
+
+test('只有两份 Review 都明确通过时才允许发布', () => {
+  const reports = new Map([
+    ['review/code-review.md', '# 代码 Review\n\n最终结论：passed\n'],
+    ['review/standards-review.md', '# 规范 Review\n\n状态：pending\n'],
+  ]);
+
+  assert.deepEqual(getUnpassedReviewFiles(reports), [
+    'review/standards-review.md',
+  ]);
+
+  reports.set(
+    'review/standards-review.md',
+    '# 规范 Review\n\n最终结论：passed\n',
+  );
+  assert.deepEqual(getUnpassedReviewFiles(reports), []);
+});
@@ -5,6 +5,7 @@ import path from 'node:path';
 import {
  getFeatureDirectory,
  getRequiredFeatureFiles,
+  getUnpassedReviewFiles,
  validateFeatureId,
 } from './feature-record.mjs';

@@ -60,6 +61,20 @@ if (missingFiles.length > 0) {
  throw new Error(`完成门禁未通过，缺少或为空：\n- ${missingFiles.join('\n- ')}`);
 }

+const reviewReports = new Map(
+  ['review/code-review.md', 'review/standards-review.md'].map((relativeFile) => [
+    relativeFile,
+    readFileSync(path.join(featureDirectory, relativeFile), 'utf8'),
+  ]),
+);
+const unpassedReviews = getUnpassedReviewFiles(reviewReports);
+
+if (unpassedReviews.length > 0) {
+  throw new Error(
+    `完成门禁未通过，Review 最终结论不是 passed：\n- ${unpassedReviews.join('\n- ')}`,
+  );
+}
+
 process.stdout.write(
  `基础门禁已通过。提交前仍须人工确认 GitNexus 影响报告、业务测试、视觉 QA 和回退说明。\n`,
 );
Author	SHA1	Message	Date
FoXiMao	4b390d9989	docs(GOV-003): 封存 Gitea 接入验证结果	2026-08-12 18:34:05 +08:00
FoXiMao	b69023e3f8	docs(GOV-003): 配置项目专用 Gitea 远程仓库	2026-08-12 18:33:09 +08:00
FoXiMao	7c7190998b	docs(GOV-002): 封存 PRD 与审查门禁版本	2026-08-12 18:27:03 +08:00
FoXiMao	fb4383f541	feat(GOV-002): 增加 PRD 与开发审查门禁	2026-08-12 18:26:31 +08:00
@@ -1 +1 @@
 .0.0
 .0.2