feat: 根目录文档、脚本、gitignore

2026-10-08 16:15:33 +08:00
commit e98660ce4e
284 changed files with 26838 additions and 0 deletions
@@ -0,0 +1,108 @@
+# 会话状态报告模板（pmassist-v3）
+
+> 用于会话恢复时自动生成状态报告。填充时读取相关文件提取数据。
+
+## 报告模板
+
+```markdown
+📊 会话状态报告
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📁 工作目录：{workdir}
+📄 文档类型：{doc_type}
+📌 项目简称：{project_alias}
+📋 文档标题：{document_title}
+🔢 当前 Round：{current_round}
+📊 会话状态：{session_status}
+
+📝 已完成内容：
+   - 章节：{completed_chapters}/{total_chapters}
+   - 功能需求(FR)：{fr_count} 条
+   - 验收标准(AC)：{ac_count} 条（覆盖 {ac_coverage}）
+   - 证据映射：{evidence_count} 条
+   - Mermaid 图：{mermaid_count} 个
+   - 表格：{table_count} 个
+
+❓ 遗留问题：
+   - P0（阻塞）：{p0_count} 个
+   - P1（关键）：{p1_count} 个
+   - P2（细节）：{p2_count} 个
+
+🎨 原型状态：{proto_status}
+   - 技术路径：{tech_stack}
+   - 产出文件：{proto_outputs}
+
+⏰ 会话时间：
+   - 创建时间：{created_at}
+   - 上次更新：{last_updated_at}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+💡 建议工作模式：
+- [A] 继续模式（补充未完成章节）
+- [B] 修改模式（新需求/变更修订）
+- [C] 局部模式（快速修改单章节）
+- [D] 原型模式（更新/生成原型）
+- [E] 定稿模式（最终审核定稿）
+- [F] AC 生成模式（批量补充验收标准）✨ v3 新增
+```
+
+## 数据来源映射
+
+### 从 session.yaml 提取
+
+```yaml
+project_alias, doc_type, title, round, status,
+fr_count, ac_count, ac_coverage,
+unresolved_questions, prototype.*
+```
+
+### 从 outputs/{doc_type}.md 提取
+
+```
+章节数：grep "^## " | wc -l
+Mermaid图：grep "```mermaid" | wc -l
+表格：grep "^|" | wc -l
+证据标注：grep "\[SRC-\|CODEMAP:\|DOMAINMAP:\|ASSUMPTION\]" | wc -l
+FR条数：grep "^#### FR-" | wc -l
+```
+
+### 从 outputs/acceptance.md 提取
+
+```
+AC条数：grep "^### AC-" | wc -l
+```
+
+### 从 questions/round_*.yaml 提取
+
+```
+P0未答数：grep "priority: P0" + "status: pending" 
+P1未答数：grep "priority: P1" + "status: pending"
+P2未答数：grep "priority: P2" + "status: pending"
+```
+
+## 健康度评估规则
+
+**🟢 健康（可继续或定稿）**
+- P0 问题 = 0
+- 证据覆盖率 >= 80%
+- FR→AC 覆盖率 >= 80%
+
+**🟡 警告（需注意）**
+- P0 问题 1-2 个
+- 证据覆盖率 50%-80%
+- FR→AC 覆盖率 50%-80%
+
+**🔴 阻塞（需修复）**
+- P0 问题 >= 3 个
+- 证据覆盖率 < 50%
+- 缺少必备文件
+
+## 工作模式推荐规则
+
+| 条件 | 推荐模式 |
+|---|---|
+| 当前 Round 未完成 / 存在遗留问题 | [A] 继续模式 |
+| 用户提出新需求 / 重写章节 | [B] 修改模式 |
+| 只微调单章节 / 修正错误 | [C] 局部模式 |
+| prototype.enabled=true / 用户要求原型 | [D] 原型模式 |
+| P0/P1=0 / 用户确认定稿 | [E] 定稿模式 |
+| FR 有但 AC 覆盖不足（<80%） | [F] AC 生成模式 |