MerCry
/
auto-ai-coding
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
auto-ai-coding/docs/progress/example-progress.md

3.1 KiB
Raw Blame History

{module}-{feature} - Progress (Example)

示例文件：用于演示 docs/session-handoff-protocol.md 的进度文档结构。 复制此文件并重命名为：docs/progress/{module}-{feature}-progress.md

📋 Context

  • module: ruoyi-forum
  • feature: REG (example)
  • status: 🔄 进行中

🔗 Spec References (SSOT)

  • agents: agents.md
  • contracting: spec/contracting.md
  • requirements: spec/ruoyi-forum/requirements.md
  • openapi_provider: spec/ruoyi-forum/openapi.provider.yaml
  • openapi_deps: spec/ruoyi-forum/openapi.deps.yaml
  • design: spec/ruoyi-forum/design.md
  • tasks: spec/ruoyi-forum/tasks.md

注意：以上路径必须与实际模块目录一致；如果文件不存在，先创建/补齐 spec，再编码。

📊 Overall Progress (Phases)

  • Phase 1: Spec 初始化与对齐 (60%) 🔄 [tasks.md: T-INIT]
  • Phase 2: Provider 实现与契约校验 (0%) ⏳ [tasks.md: T-PROVIDER]
  • Phase 3: Consumer 并行开发（Mock/SDK） (0%) ⏳ [tasks.md: T-CONSUMER]
  • Phase 4: 集成测试 / 回归 / 合并门禁 (0%) ⏳ [tasks.md: T-INTEGRATION]

🔄 Current Phase

Goal

在 spec/ruoyi-forum/ 下完成 requirements + openapi(provider/deps) 的最小可并行版本。

Sub Tasks

  • 梳理模块边界与依赖清单 ✅ [tasks.md: T-INIT-01]
  • 生成 requirements.md 草案 🔄 [tasks.md: T-INIT-02]
  • 生成 openapi.provider.yaml 与 openapi.deps.yaml (L0) ⏳ [tasks.md: T-INIT-03]

Next Action (Must be Specific)

Immediate: 生成 spec/ruoyi-forum/requirements.md 的验收标准（AC）与 Traceability 映射表。

Details:

  1. file: spec/ruoyi-forum/requirements.md
  2. action: 补齐至少 3 条 AC（EARS），并在 Traceability 表中映射到计划中的 endpoint。
  3. reference:
    • docs/spec-product-zh.md（requirements 模板与 traceability 要求）
    • agents.md（必须先读 spec 再编码、AC 追踪硬规则）
  4. constraints:
    • 不得在未更新 requirements 的情况下更改业务口径
    • AC ID 必须稳定可追溯（示例：AC-REG-01）

🏗️ Technical Context

Module Structure (Only What Matters)

  • spec/ruoyi-forum/
    • requirements.md
    • openapi.provider.yaml
    • openapi.deps.yaml
    • design.md
    • tasks.md

Key Decisions (Why / Impact)

  • decision: OpenAPI 拆分 provider/deps reason: 支持 consumer-first 并行开发；调用方可基于 deps 生成 mock/SDK impact: provider 实现需在合并前提升 provider 契约到 L2 并通过契约校验

Code Snippets (Optional but Recommended)

// 示例：在 controller / @Operation / 测试用例 / commit 中包含 [AC-...] 以便追踪
// [AC-REG-01]

🧾 Session History

Session #1 (YYYY-MM-DD)

  • completed:
    • 初始化 Phase 划分与任务清单
  • changes:
    • 新增 docs/progress/example-progress.md

🚀 Startup Guide

  1. 读取本进度文档，定位当前 Phase 与 Next Action。
  2. 打开并阅读 Spec References 指向的模块规范（requirements/openapi/tasks）。
  3. 直接执行 Next Action；遇到缺口先更新 spec 再编码。