mspec-cli 4.0.13__tar.gz → 5.0.0__tar.gz

{mspec_cli-4.0.13/src/mspec_cli.egg-info → mspec_cli-5.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mspec-cli
-Version: 4.0.13
+Version: 5.0.0
 Summary: mspec-cli（Member Spec）- 会员组规范驱动开发工作流 CLI 工具
 Author-email: shirayner <team@mspec.io>
 License: MIT
@@ -45,14 +45,15 @@ Dynamic: license-file
 
 **mspec-cli**（Member Spec）- 会员组规范驱动开发工作流 CLI 工具
 
-通过交互式命令行澄清机制，实现结构化问题发现与澄清，提升需求明确度和开发效率。
+通过交互式命令行澄清机制，实现结构化问题发现与澄清；通过自发进化体系，使 AI 随着项目积累越来越了解你的项目。
 
 ## 特性
 
 - 🚀 **一键安装** - `pip install mspec-cli` 即可使用
-- 🔄 **交互式澄清** - 一问一答的引导式交互界面
+- 🔄 **批量式澄清** - 一次性列出所有问题，统一回答，高效不拖沓
 - 💾 **断点续传** - 支持随时中断，下次自动恢复
 - 📚 **结构化问题分类** - 6个需求维度 + 7个设计维度
+- 🧬 **自发进化体系** - 使用越久，整个 spec coding 流程越精准
 - 🎨 **美观界面** - 使用 Rich 库提供彩色终端输出
 
 ## 文档
@@ -197,9 +198,59 @@ mspec doctor
 └─────────────────────────────────────┘
     │
     ▼
-实施 (apply)
+┌─────────────────────────────────────┐
+│  实施 (apply)                        │
+│  - 按任务清单逐步实施                │
+│  - 可选：记录实施中的轻量观察        │
+└─────────────────────────────────────┘
+    │
+    ▼
+┌─────────────────────────────────────┐
+│  归档 (archive) + 进化               │
+│  - 生成复盘报告（9个维度）           │
+│  - 更新项目知识库（ADR/词汇/风险）   │
+│  - 积累 3 次后自动触发进化分析       │
+└─────────────────────────────────────┘
 ```
 
+## 🧬 进化体系
+
+mspec 内置 3层8维度 的完整进化体系，无需额外命令，每次 archive 自动推进：
+
+### Layer A — 项目事实（每次立即更新）
+
+| 文件 | 内容 | 作用 |
+|------|------|------|
+| `openspec/decisions/adr.md` | 技术决策账本 | 不重复讨论已决定的事 |
+| `openspec/glossary.md` | 领域词汇表 | 统一业务术语命名 |
+| `openspec/risk-map.md` | 风险图谱 | 已知高风险区和 bug 模式 |
+
+### Layer B — 流程模式（积累 3+ 次后自动触发）
+
+| 文件 | 内容 | 作用 |
+|------|------|------|
+| `openspec/templates/*.md` | 进化后的问题分类学 | 精准识别项目特有问题 |
+| `openspec/task-patterns/` | 任务模板库 | 按 change 类型分解任务 |
+| `openspec/config.yaml` | 用户偏好档案 | 减少重复对齐 |
+
+### Layer C — 元信号（长期积累）
+
+| 文件 | 内容 | 作用 |
+|------|------|------|
+| `openspec/specs/CHANGELOG.md` | 规格演化日志 | 揭示业务边界稳定性 |
+| `openspec/metrics.md` | 效率信号 | 发现系统性瓶颈 |
+
+### 预期效果
+
+| 时间点 | 效果 |
+|--------|------|
+| 第 1 次 archive | ADR 建立，词汇表开始填充 |
+| 第 3 次 archive | 首次触发进化，分类学开始个性化 |
+| 第 5-10 次 | 澄清轮次减少，apply 意外减少 |
+| 长期（20+次） | 项目知识库完备，AI 越来越了解项目 |
+
+
+
 ## 问题分类学
 
 ### 需求问题 (6个维度)
@@ -225,32 +276,33 @@ mspec doctor
 
 ```
 =================================================================
-📋 问题 [3/8] - 功能点: 用户管理
+📋 需求澄清 - 批量确认（共 4 个问题：3 High，1 Medium）
 =================================================================
 
-❓ 问题：用户资料需要包含哪些字段？
+需要确认 4 个问题，请一并回答：
+
+1. 🔴 [功能完整性] 用户资料需要包含哪些字段？
+   选项：A) 基础版：用户名、邮箱、手机号
+         B) 标准版：用户名、邮箱、手机号、头像、昵称
+         C) 完整版：基础 + 部门、职位、入职日期
+         D) 自定义
 
-💡 说明：
-   当前需求中"用户资料"范围不明确，需要明确包含哪些
-   必填字段和选填字段，这将影响数据库设计和前端表单开发。
+2. 🔴 [数据相关] 手机号字段需要验证格式吗？
+   选项：A) 不验证  B) 基础验证：11 位数字  C) 严格验证国内规则
 
-🔘 备选选项：
+3. 🟡 [用户体验] 用户注册后需要邮箱验证吗？
+   选项：A) 不需要  B) 需要，否则无法登录  C) 需要，但可跳过
 
-   A) 基础版：用户名、邮箱、手机号
-   B) 标准版：用户名、邮箱、手机号、头像、昵称
-   C) 完整版：用户名、邮箱、手机号、头像、昵称、
-              部门、职位、入职日期
-   D) 自定义...
+4. 🔴 [边界与异常] 用户名重复时的处理方式？
+   选项：A) 报错提示  B) 自动加数字后缀  C) 让用户重新输入
 
-✏️ 你的选择:
+请输入各题答案（如：1A 2B 3C 4A），或输入 q 退出保存：
 =================================================================
 ```
 
 **操作指令：**
-- `A`, `B`, `C`, `D`... - 选择对应选项
-- `E` 或最后一个选项 - 选择自定义输入模式
+- 按编号回答每道题，一次性提交所有答案（如：`1A 2B 3C 4A`）
 - `q` - 退出保存，下次自动恢复
-- `s` - 跳过当前问题（仅 Low 优先级）
 
 ## 配置
 

{mspec_cli-4.0.13 → mspec_cli-5.0.0}/README.md

@@ -6,14 +6,15 @@
 
 **mspec-cli**（Member Spec）- 会员组规范驱动开发工作流 CLI 工具
 
-通过交互式命令行澄清机制，实现结构化问题发现与澄清，提升需求明确度和开发效率。
+通过交互式命令行澄清机制，实现结构化问题发现与澄清；通过自发进化体系，使 AI 随着项目积累越来越了解你的项目。
 
 ## 特性
 
 - 🚀 **一键安装** - `pip install mspec-cli` 即可使用
-- 🔄 **交互式澄清** - 一问一答的引导式交互界面
+- 🔄 **批量式澄清** - 一次性列出所有问题，统一回答，高效不拖沓
 - 💾 **断点续传** - 支持随时中断，下次自动恢复
 - 📚 **结构化问题分类** - 6个需求维度 + 7个设计维度
+- 🧬 **自发进化体系** - 使用越久，整个 spec coding 流程越精准
 - 🎨 **美观界面** - 使用 Rich 库提供彩色终端输出
 
 ## 文档
@@ -158,9 +159,59 @@ mspec doctor
 └─────────────────────────────────────┘
     │
     ▼
-实施 (apply)
+┌─────────────────────────────────────┐
+│  实施 (apply)                        │
+│  - 按任务清单逐步实施                │
+│  - 可选：记录实施中的轻量观察        │
+└─────────────────────────────────────┘
+    │
+    ▼
+┌─────────────────────────────────────┐
+│  归档 (archive) + 进化               │
+│  - 生成复盘报告（9个维度）           │
+│  - 更新项目知识库（ADR/词汇/风险）   │
+│  - 积累 3 次后自动触发进化分析       │
+└─────────────────────────────────────┘
 ```
 
+## 🧬 进化体系
+
+mspec 内置 3层8维度 的完整进化体系，无需额外命令，每次 archive 自动推进：
+
+### Layer A — 项目事实（每次立即更新）
+
+| 文件 | 内容 | 作用 |
+|------|------|------|
+| `openspec/decisions/adr.md` | 技术决策账本 | 不重复讨论已决定的事 |
+| `openspec/glossary.md` | 领域词汇表 | 统一业务术语命名 |
+| `openspec/risk-map.md` | 风险图谱 | 已知高风险区和 bug 模式 |
+
+### Layer B — 流程模式（积累 3+ 次后自动触发）
+
+| 文件 | 内容 | 作用 |
+|------|------|------|
+| `openspec/templates/*.md` | 进化后的问题分类学 | 精准识别项目特有问题 |
+| `openspec/task-patterns/` | 任务模板库 | 按 change 类型分解任务 |
+| `openspec/config.yaml` | 用户偏好档案 | 减少重复对齐 |
+
+### Layer C — 元信号（长期积累）
+
+| 文件 | 内容 | 作用 |
+|------|------|------|
+| `openspec/specs/CHANGELOG.md` | 规格演化日志 | 揭示业务边界稳定性 |
+| `openspec/metrics.md` | 效率信号 | 发现系统性瓶颈 |
+
+### 预期效果
+
+| 时间点 | 效果 |
+|--------|------|
+| 第 1 次 archive | ADR 建立，词汇表开始填充 |
+| 第 3 次 archive | 首次触发进化，分类学开始个性化 |
+| 第 5-10 次 | 澄清轮次减少，apply 意外减少 |
+| 长期（20+次） | 项目知识库完备，AI 越来越了解项目 |
+
+
+
 ## 问题分类学
 
 ### 需求问题 (6个维度)
@@ -186,32 +237,33 @@ mspec doctor
 
 ```
 =================================================================
-📋 问题 [3/8] - 功能点: 用户管理
+📋 需求澄清 - 批量确认（共 4 个问题：3 High，1 Medium）
 =================================================================
 
-❓ 问题：用户资料需要包含哪些字段？
+需要确认 4 个问题，请一并回答：
+
+1. 🔴 [功能完整性] 用户资料需要包含哪些字段？
+   选项：A) 基础版：用户名、邮箱、手机号
+         B) 标准版：用户名、邮箱、手机号、头像、昵称
+         C) 完整版：基础 + 部门、职位、入职日期
+         D) 自定义
 
-💡 说明：
-   当前需求中"用户资料"范围不明确，需要明确包含哪些
-   必填字段和选填字段，这将影响数据库设计和前端表单开发。
+2. 🔴 [数据相关] 手机号字段需要验证格式吗？
+   选项：A) 不验证  B) 基础验证：11 位数字  C) 严格验证国内规则
 
-🔘 备选选项：
+3. 🟡 [用户体验] 用户注册后需要邮箱验证吗？
+   选项：A) 不需要  B) 需要，否则无法登录  C) 需要，但可跳过
 
-   A) 基础版：用户名、邮箱、手机号
-   B) 标准版：用户名、邮箱、手机号、头像、昵称
-   C) 完整版：用户名、邮箱、手机号、头像、昵称、
-              部门、职位、入职日期
-   D) 自定义...
+4. 🔴 [边界与异常] 用户名重复时的处理方式？
+   选项：A) 报错提示  B) 自动加数字后缀  C) 让用户重新输入
 
-✏️ 你的选择:
+请输入各题答案（如：1A 2B 3C 4A），或输入 q 退出保存：
 =================================================================
 ```
 
 **操作指令：**
-- `A`, `B`, `C`, `D`... - 选择对应选项
-- `E` 或最后一个选项 - 选择自定义输入模式
+- 按编号回答每道题，一次性提交所有答案（如：`1A 2B 3C 4A`）
 - `q` - 退出保存，下次自动恢复
-- `s` - 跳过当前问题（仅 Low 优先级）
 
 ## 配置
 

{mspec_cli-4.0.13 → mspec_cli-5.0.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "mspec-cli"
-version = "4.0.13"
+version = "5.0.0"
 description = "mspec-cli（Member Spec）- 会员组规范驱动开发工作流 CLI 工具"
 readme = "README.md"
 license = {text = "MIT"}

{mspec_cli-4.0.13 → mspec_cli-5.0.0}/src/mspec/__init__.py

@@ -1,5 +1,5 @@
 """mspec（Member Spec）- 会员组规范驱动开发工作流 CLI 工具"""
 
-__version__ = "4.0.13"
+__version__ = "5.0.0"
 __author__ = "mspec Team"
 __email__ = "team@mspec.io"

mspec_cli-5.0.0/src/mspec/templates/adr.md

@@ -0,0 +1,23 @@
+# 技术决策账本（Architecture Decision Records）
+
+> **用途**: 记录项目中已做出的架构和技术决策，避免重复讨论已决定的事项。
+> **更新时机**: 每次 archive 时，自动从复盘报告提取新决策追加。
+>
+> **如何消费**:
+> - design 阶段：先查询此文件，已有决策不重复讨论
+> - explore 阶段：比较技术方案时直接引用
+> - propose 阶段：评估 Impact 时与已有决策对齐
+
+---
+
+<!-- 格式：
+## {决策标题} | 来源: {change-name} | 日期: {YYYY-MM-DD}
+
+**选择**: 选了什么方案
+**理由**: 为什么选择这个方案
+**备选**: 考虑过哪些其他方案
+**放弃原因**: 为什么放弃备选方案
+**状态**: active / superseded / deprecated
+-->
+
+*暂无决策记录。第一次 archive 后将自动填充。*