workflow-loop 0.1.0__tar.gz → 0.2.0__tar.gz

{workflow_loop-0.1.0/src/workflow_loop.egg-info → workflow_loop-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: workflow-loop
-Version: 0.1.0
+Version: 0.2.0
 Summary: 为 AI 驱动的软件开发提供有状态、可验证、可回退的工作流管理。
 Author: yuzyf
 License-Expression: MIT
@@ -9,6 +9,7 @@ Project-URL: Repository, https://github.com/yuzyf/workflow_loop
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Requires-Dist: packaging>=24.0
 Provides-Extra: dev
 Requires-Dist: build>=1.2; extra == "dev"
 Requires-Dist: pytest>=7.0; extra == "dev"
@@ -31,28 +32,29 @@ Workflow Loop 把一次软件修改拆成有顺序的工作环节，并用程序
 ### 能做什么
 
 - **保存进度**：在项目的 `.workflow_loop/` 目录保存当前工作环节、确认状态和机器执行记录，下一次对话可以从真实状态继续。
-- **控制推进**：每个环节依次经过讨论完成、程序检查和用户确认三道门，前一步不满足时不能进入下一步。
+- **控制推进**：完整研发任务的每个环节依次经过讨论完成、程序检查和用户确认三道门；无需开发任务走独立的讨论、执行、结果确认简单流程。
 - **连接交付证据**：把产品设计、验收条件、测试项、实施记录和最终结果放进同一条可追踪链路。
 - **保护项目修改**：实施前保存计划修改文件的原内容；需要退回上游或作废整轮时，按工作流规则使旧结果失效或恢复受管内容。
-- **管理三种工作**：分别处理从零创建、修改现有产品和修复缺陷，按工作类型生成对应的环节路径。
+- **管理四种工作**：分别处理从零创建、修改现有产品、修复缺陷和无需开发任务；只有前三种生成研发环节路径。
 
 ### 不做什么
 
 - 不替代 AI 编码助手、版本控制系统或持续集成服务，也不替用户决定产品需求是否正确。
 - 不允许跳过必要讨论、程序检查或用户确认，把未经验证的内容当成交付结果。
-- 不自动安装 Python，不自动升级或修复已有的异常安装，也不同时维护多个产品版本。
-- 当前只支持 `from_scratch`（从零创建）、`product_change`（修改现有产品）和 `bugfix`（修复缺陷）三种正式工作意图。
+- 不自动安装 Python，不静默更新，也不把残缺项目当成完整安装覆盖；更新必须由用户明确执行并确认。
+- `light_task`（无需开发任务）不能用于修改正式产品规则、产品代码、测试代码，或影响运行、构建、测试、部署和依赖的配置；发现需要开发时必须结束简单轮次，经用户确认后改走完整研发路线。
 
 ## 工作流程
 
-`intent`（工作意图）决定一轮工作需要经过哪些环节。各意图的具体环节不同，但每个需要正式确认的环节都遵守同一组三道门。
+`intent`（工作意图）决定一轮工作走完整研发流程还是简单流程。AI 先调查并推荐路线，用户确认要进入哪种任务后才能启动。
 
 ```mermaid
 flowchart TD
-    A["用户提出需求"] --> B{"选择工作意图"}
+    A["用户提出需求"] --> B{"AI 推荐路线，用户确认"}
     B -->|"from_scratch：从零创建"| C1["生成从零开发路径"]
     B -->|"product_change：修改产品"| C2["生成产品修改路径"]
     B -->|"bugfix：修复缺陷"| C3["生成缺陷修复路径"]
+    B -->|"light_task：无需开发任务"| L1["逐个问题讨论，AI 给出建议"]
     C1 --> D["进入当前工作环节"]
     C2 --> D
     C3 --> D
@@ -64,14 +66,21 @@ flowchart TD
     I --> J{"还有下一环节？"}
     J -->|"有"| D
     J -->|"没有"| K["记录完成并正式收工"]
+    L1 --> L2["用户确认讨论完毕"]
+    L2 --> L3["执行约定任务"]
+    L3 --> L4["核对并展示真实结果"]
+    L4 --> L5["用户确认结果"]
+    L5 --> K
 ```
 
-三道门分别解决不同问题：
+完整研发路线的三道门分别解决不同问题：
 
 1. **讨论完成**：需求、限制和实施计划已经与用户逐项达成共识，允许开始写正式产物。
 2. **程序检查**：程序核对必需文件、结构、关联、代码变化或测试记录等可机械判断的事实。
 3. **用户确认**：用户确认实际内容符合意图，程序记录确认后才进入下一环节。
 
+`light_task`（无需开发任务）是一类任务，不是“改文档、提交、发布”三个固定选项。它也要求先调查和讨论：AI 用第一性原理梳理需求，每次只问一个问题并给出建议，用户确认讨论完毕后才执行。执行 `commit`（本地 Git 提交）、`push`（推送远端）、发布、删除等难撤销操作前，要按准确操作单独确认；“提交代码”必须先问清是只 `commit`，还是还要 `push`。完成后，AI 按约定方法展示真实结果，用户确认后收工。简单流程不创建研发阶段、三道门、固定全量测试或回退副本；失败或作废时保留真实现场并说明结果，不自动回滚。
+
 ## 环境要求
 
 - Python 3.11 或更高版本；安装脚本只检查版本，不会代替用户安装 Python。
@@ -80,29 +89,76 @@ flowchart TD
 - 安装时能够访问 GitHub 和 PyPI（Python 公共软件包仓库）。
 - 执行安装命令前，先进入要由 Workflow Loop 管理的项目根目录。
 
-## 安装 0.1.0
+## 安装 0.2.0
 
 安装器先进行只读检查并列出项目侧和电脑侧可能发生的全部持久修改。用户确认一次后，安装器才安装或复用全局 `workflow` 命令，并把智能体契约、产物模板和工作规范写入当前项目；用户取消或安装失败时不会留下只完成一部分的安装。
 
 ### macOS
 
 ```bash
-curl -fsSL https://github.com/yuzyf/workflow_loop/releases/download/v0.1.0/install.sh | bash
+curl -fsSL https://github.com/yuzyf/workflow_loop/releases/download/v0.2.0/install.sh | bash
 ```
 
 ### Linux
 
 ```bash
-curl -fsSL https://github.com/yuzyf/workflow_loop/releases/download/v0.1.0/install.sh | bash
+curl -fsSL https://github.com/yuzyf/workflow_loop/releases/download/v0.2.0/install.sh | bash
 ```
 
 ### 原生 Windows
 
 ```powershell
-powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://github.com/yuzyf/workflow_loop/releases/download/v0.1.0/install.ps1 | iex"
+powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://github.com/yuzyf/workflow_loop/releases/download/v0.2.0/install.ps1 | iex"
+```
+
+安装命令固定读取 `v0.2.0` 正式发布中的脚本；不会跟随内容可能变化的 `latest`（最新版本）地址。
+
+## 更新与卸载
+
+下面的维护命令都由用户从项目根目录主动执行，并且在持久修改前只确认一次。`workflow update` 默认核对 PyPI 和 GitHub Release 后更新到双方一致的最新正式版本；`--version` 后的版本号必须是比电脑全局命令和当前项目都不低的正式版本。
+
+```bash
+workflow update
+workflow update --version 0.2.0
 ```
 
-安装命令固定读取 `v0.1.0` 正式发布中的脚本；不会跟随内容可能变化的 `latest`（最新版本）地址。
+更新按需补齐电脑全局命令和当前项目，只直接覆盖项目根 `AGENTS.md`、`.workflow_loop/Template_Repository/`、`.workflow_loop/Standardized_Repository/`，以及 `.workflow_loop/project.json` 中的安装版本字段。更新不创建备份，不回滚已经完成的步骤；当前轮次状态、历史、回退资料、业务代码和正式产物保持不变。失败后重新执行同一命令即可继续补齐。
+
+没有 `workflow update` 命令的旧版本，可从项目根目录直接运行最新正式发布提供的脚本：
+
+```bash
+# macOS / Linux
+curl -fsSL https://github.com/yuzyf/workflow_loop/releases/latest/download/update.sh | bash
+```
+
+```powershell
+# Windows PowerShell 5.1 / 7
+powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://github.com/yuzyf/workflow_loop/releases/latest/download/update.ps1 | iex"
+```
+
+项目卸载和电脑全局命令卸载是两个独立动作：
+
+```bash
+# 强制删除当前项目的 AGENTS.md、整个 .workflow_loop/ 和安装事务残留
+workflow uninstall
+
+# 只删除电脑全局命令；不会扫描或删除任何项目
+workflow uninstall --global
+```
+
+项目卸载不检查当前轮次处于进行中、已完成还是已作废，也不恢复本轮业务修改；删除没有备份。全局卸载只清理全局工具和能够由安装来源记录证明是 Workflow Loop 添加的 `PATH`（命令搜索路径）项，来源不明或用户原本就有的 PATH 项会保留并报告。全局命令删除后，其它已安装项目仍保留，但在重新安装全局命令前不能运行 `workflow`。
+
+旧版本没有公开卸载命令时，可从项目根运行 `uninstall.sh` 或 `uninstall.ps1` 的最新正式发布资产；两个脚本默认只卸载当前项目，不会先升级或删除电脑全局命令。
+
+```bash
+# macOS / Linux 旧版本项目卸载
+curl -fsSL https://github.com/yuzyf/workflow_loop/releases/latest/download/uninstall.sh | bash
+```
+
+```powershell
+# Windows PowerShell 5.1 / 7 旧版本项目卸载
+powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://github.com/yuzyf/workflow_loop/releases/latest/download/uninstall.ps1 | iex"
+```
 
 ## 最小使用示例
 
@@ -115,9 +171,10 @@ powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://github.com/y
 之后由 AI 编码助手执行日常流程：
 
 1. 自动运行 `workflow start` 检查当前状态，并根据事实与用户确认本轮工作意图。
-2. 严格执行每条命令输出的“下一步”，每次只向用户确认一个问题。
-3. 在写代码前完成需求、验收、测试和实施计划，在受保护的回退基线上实施修改。
-4. 使用机器记录完成测试，经过主题验收和最终全量回归后正式收工。
+2. 调查现状并推荐四种路线之一，用户确认进入该任务后才启动轮次。
+3. 严格执行每条命令输出的“下一步”，讨论时每次只问用户一个问题。
+4. 完整研发路线在写代码前完成需求、验收、测试和实施计划；无需开发任务在用户确认讨论完毕后直接执行约定内容。
+5. 把真实结果交给用户核对并确认，再正式收工。
 
 用户不需要手工执行日常 `workflow` 命令；用户只负责描述需求、回答讨论问题、确认安装范围和确认各环节结果。
 
@@ -127,8 +184,11 @@ powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://github.com/y
 
 | 命令 | 中文含义 |
 |---|---|
-| `workflow start` | 检查当前轮次；没有进行中的工作时列出三种工作意图 |
-| `workflow start --intent <intent>` | 用指定工作意图开始一轮；`<intent>` 表示 `from_scratch`、`product_change` 或 `bugfix` |
+| `workflow start` | 检查当前轮次；没有进行中的工作时列出四种工作意图 |
+| `workflow start --intent <intent>` | 用户确认路线后开始一轮；`<intent>` 表示 `from_scratch`、`product_change`、`bugfix` 或 `light_task` |
+| `workflow light --discuss-done --task <任务> --verification <方法>` | 记录无需开发任务已讨论完毕；`<任务>` 是约定范围，`<方法>` 是结果核对方法 |
+| `workflow light --approve-action <准确操作>` | 记录用户单独批准的一项难撤销操作，只记录批准，不自动执行 |
+| `workflow light --confirmed --result <实际结果>` | 记录用户已经核对无需开发任务的真实结果 |
 | `workflow discuss` | 加载当前环节必须遵守的模板、规范和项目材料 |
 | `workflow gate <stage> --discuss-done` | 通过当前环节的讨论完成门；`<stage>` 表示当前环节标识 |
 | `workflow gate <stage>` | 让程序检查当前环节的文件、结构和可验证事实 |
@@ -137,8 +197,12 @@ powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://github.com/y
 | `workflow test ...` | 登记统一测试入口、准备测试项或执行受控测试 |
 | `workflow acceptance ...` | 记录需要用户判断的主题验收回答 |
 | `workflow return --to <stage> --reason <reason>` | 带具体原因退回上游环节，并使受影响的下游结果失效；`<reason>` 表示退回原因 |
-| `workflow abort` | 作废当前整轮，并按回退清单恢复受管内容 |
+| `workflow abort` | 作废完整研发轮次，并按回退清单恢复受管内容 |
+| `workflow abort --summary <真实状态>` | 作废无需开发任务，保留已发生状态并记录实际完成、未执行或失败内容 |
 | `workflow done` | 在最后一个环节确认后记录整轮完成并清理临时回退副本 |
+| `workflow update [--version <version>]` | 更新电脑全局命令和当前项目；`<version>` 表示可选的目标正式版本 |
+| `workflow uninstall` | 不管当前轮次状态，强制删除当前项目固定的 Workflow Loop 管理内容 |
+| `workflow uninstall --global` | 只卸载电脑全局 Workflow Loop 命令和来源明确的 PATH 项，不扫描项目 |
 
 可运行 `workflow --help` 查看当前版本提供的完整参数。
 
@@ -169,6 +233,10 @@ workflow_loop/
 ├── impl/                  实施计划与实施记录
 ├── install.sh             macOS 和 Linux 安装脚本
 ├── install.ps1            Windows 安装脚本
+├── update.sh              macOS 和 Linux 旧版本更新脚本
+├── update.ps1             Windows 旧版本更新脚本
+├── uninstall.sh           macOS 和 Linux 旧版本卸载脚本
+├── uninstall.ps1          Windows 旧版本卸载脚本
 ├── CONTEXT.md             产品术语、规则和限制
 └── DESIGN.md              实现设计文档
 ```
@@ -177,6 +245,9 @@ workflow_loop/
 
 - [产品总说明](spec/产品总说明.md)：产品目的、范围、使用者和通用规则。
 - [安装到项目](spec/功能_安装到项目.md)：支持环境、安装行为、异常处理和公开发布要求。
+- [更新已安装项目](spec/功能_更新已安装项目.md)：目标版本、覆盖范围、保留范围和失败重试规则。
+- [卸载 Workflow Loop](spec/功能_卸载_Workflow_Loop.md)：项目强制卸载和电脑全局卸载的独立边界。
+- [处理无需开发任务](spec/功能_处理无需开发任务.md)：简单流程适用边界、逐项确认、完成和异常处理规则。
 - [代码架构设计](spec/代码架构设计.md)：功能到代码模块、状态和外部依赖的对应关系。
 - [实现设计文档](DESIGN.md)：命令、数据模型、工作意图、阶段路径和门禁的实现形态。
 - [产品事实与约束](CONTEXT.md)：当前有效的术语、约束和设计决策。

{workflow_loop-0.1.0 → workflow_loop-0.2.0}/README.md

@@ -14,28 +14,29 @@ Workflow Loop 把一次软件修改拆成有顺序的工作环节，并用程序
 ### 能做什么
 
 - **保存进度**：在项目的 `.workflow_loop/` 目录保存当前工作环节、确认状态和机器执行记录，下一次对话可以从真实状态继续。
-- **控制推进**：每个环节依次经过讨论完成、程序检查和用户确认三道门，前一步不满足时不能进入下一步。
+- **控制推进**：完整研发任务的每个环节依次经过讨论完成、程序检查和用户确认三道门；无需开发任务走独立的讨论、执行、结果确认简单流程。
 - **连接交付证据**：把产品设计、验收条件、测试项、实施记录和最终结果放进同一条可追踪链路。
 - **保护项目修改**：实施前保存计划修改文件的原内容；需要退回上游或作废整轮时，按工作流规则使旧结果失效或恢复受管内容。
-- **管理三种工作**：分别处理从零创建、修改现有产品和修复缺陷，按工作类型生成对应的环节路径。
+- **管理四种工作**：分别处理从零创建、修改现有产品、修复缺陷和无需开发任务；只有前三种生成研发环节路径。
 
 ### 不做什么
 
 - 不替代 AI 编码助手、版本控制系统或持续集成服务，也不替用户决定产品需求是否正确。
 - 不允许跳过必要讨论、程序检查或用户确认，把未经验证的内容当成交付结果。
-- 不自动安装 Python，不自动升级或修复已有的异常安装，也不同时维护多个产品版本。
-- 当前只支持 `from_scratch`（从零创建）、`product_change`（修改现有产品）和 `bugfix`（修复缺陷）三种正式工作意图。
+- 不自动安装 Python，不静默更新，也不把残缺项目当成完整安装覆盖；更新必须由用户明确执行并确认。
+- `light_task`（无需开发任务）不能用于修改正式产品规则、产品代码、测试代码，或影响运行、构建、测试、部署和依赖的配置；发现需要开发时必须结束简单轮次，经用户确认后改走完整研发路线。
 
 ## 工作流程
 
-`intent`（工作意图）决定一轮工作需要经过哪些环节。各意图的具体环节不同，但每个需要正式确认的环节都遵守同一组三道门。
+`intent`（工作意图）决定一轮工作走完整研发流程还是简单流程。AI 先调查并推荐路线，用户确认要进入哪种任务后才能启动。
 
 ```mermaid
 flowchart TD
-    A["用户提出需求"] --> B{"选择工作意图"}
+    A["用户提出需求"] --> B{"AI 推荐路线，用户确认"}
     B -->|"from_scratch：从零创建"| C1["生成从零开发路径"]
     B -->|"product_change：修改产品"| C2["生成产品修改路径"]
     B -->|"bugfix：修复缺陷"| C3["生成缺陷修复路径"]
+    B -->|"light_task：无需开发任务"| L1["逐个问题讨论，AI 给出建议"]
     C1 --> D["进入当前工作环节"]
     C2 --> D
     C3 --> D
@@ -47,14 +48,21 @@ flowchart TD
     I --> J{"还有下一环节？"}
     J -->|"有"| D
     J -->|"没有"| K["记录完成并正式收工"]
+    L1 --> L2["用户确认讨论完毕"]
+    L2 --> L3["执行约定任务"]
+    L3 --> L4["核对并展示真实结果"]
+    L4 --> L5["用户确认结果"]
+    L5 --> K
 ```
 
-三道门分别解决不同问题：
+完整研发路线的三道门分别解决不同问题：
 
 1. **讨论完成**：需求、限制和实施计划已经与用户逐项达成共识，允许开始写正式产物。
 2. **程序检查**：程序核对必需文件、结构、关联、代码变化或测试记录等可机械判断的事实。
 3. **用户确认**：用户确认实际内容符合意图，程序记录确认后才进入下一环节。
 
+`light_task`（无需开发任务）是一类任务，不是“改文档、提交、发布”三个固定选项。它也要求先调查和讨论：AI 用第一性原理梳理需求，每次只问一个问题并给出建议，用户确认讨论完毕后才执行。执行 `commit`（本地 Git 提交）、`push`（推送远端）、发布、删除等难撤销操作前，要按准确操作单独确认；“提交代码”必须先问清是只 `commit`，还是还要 `push`。完成后，AI 按约定方法展示真实结果，用户确认后收工。简单流程不创建研发阶段、三道门、固定全量测试或回退副本；失败或作废时保留真实现场并说明结果，不自动回滚。
+
 ## 环境要求
 
 - Python 3.11 或更高版本；安装脚本只检查版本，不会代替用户安装 Python。
@@ -63,29 +71,76 @@ flowchart TD
 - 安装时能够访问 GitHub 和 PyPI（Python 公共软件包仓库）。
 - 执行安装命令前，先进入要由 Workflow Loop 管理的项目根目录。
 
-## 安装 0.1.0
+## 安装 0.2.0
 
 安装器先进行只读检查并列出项目侧和电脑侧可能发生的全部持久修改。用户确认一次后，安装器才安装或复用全局 `workflow` 命令，并把智能体契约、产物模板和工作规范写入当前项目；用户取消或安装失败时不会留下只完成一部分的安装。
 
 ### macOS
 
 ```bash
-curl -fsSL https://github.com/yuzyf/workflow_loop/releases/download/v0.1.0/install.sh | bash
+curl -fsSL https://github.com/yuzyf/workflow_loop/releases/download/v0.2.0/install.sh | bash
 ```
 
 ### Linux
 
 ```bash
-curl -fsSL https://github.com/yuzyf/workflow_loop/releases/download/v0.1.0/install.sh | bash
+curl -fsSL https://github.com/yuzyf/workflow_loop/releases/download/v0.2.0/install.sh | bash
 ```
 
 ### 原生 Windows
 
 ```powershell
-powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://github.com/yuzyf/workflow_loop/releases/download/v0.1.0/install.ps1 | iex"
+powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://github.com/yuzyf/workflow_loop/releases/download/v0.2.0/install.ps1 | iex"
+```
+
+安装命令固定读取 `v0.2.0` 正式发布中的脚本；不会跟随内容可能变化的 `latest`（最新版本）地址。
+
+## 更新与卸载
+
+下面的维护命令都由用户从项目根目录主动执行，并且在持久修改前只确认一次。`workflow update` 默认核对 PyPI 和 GitHub Release 后更新到双方一致的最新正式版本；`--version` 后的版本号必须是比电脑全局命令和当前项目都不低的正式版本。
+
+```bash
+workflow update
+workflow update --version 0.2.0
 ```
 
-安装命令固定读取 `v0.1.0` 正式发布中的脚本；不会跟随内容可能变化的 `latest`（最新版本）地址。
+更新按需补齐电脑全局命令和当前项目，只直接覆盖项目根 `AGENTS.md`、`.workflow_loop/Template_Repository/`、`.workflow_loop/Standardized_Repository/`，以及 `.workflow_loop/project.json` 中的安装版本字段。更新不创建备份，不回滚已经完成的步骤；当前轮次状态、历史、回退资料、业务代码和正式产物保持不变。失败后重新执行同一命令即可继续补齐。
+
+没有 `workflow update` 命令的旧版本，可从项目根目录直接运行最新正式发布提供的脚本：
+
+```bash
+# macOS / Linux
+curl -fsSL https://github.com/yuzyf/workflow_loop/releases/latest/download/update.sh | bash
+```
+
+```powershell
+# Windows PowerShell 5.1 / 7
+powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://github.com/yuzyf/workflow_loop/releases/latest/download/update.ps1 | iex"
+```
+
+项目卸载和电脑全局命令卸载是两个独立动作：
+
+```bash
+# 强制删除当前项目的 AGENTS.md、整个 .workflow_loop/ 和安装事务残留
+workflow uninstall
+
+# 只删除电脑全局命令；不会扫描或删除任何项目
+workflow uninstall --global
+```
+
+项目卸载不检查当前轮次处于进行中、已完成还是已作废，也不恢复本轮业务修改；删除没有备份。全局卸载只清理全局工具和能够由安装来源记录证明是 Workflow Loop 添加的 `PATH`（命令搜索路径）项，来源不明或用户原本就有的 PATH 项会保留并报告。全局命令删除后，其它已安装项目仍保留，但在重新安装全局命令前不能运行 `workflow`。
+
+旧版本没有公开卸载命令时，可从项目根运行 `uninstall.sh` 或 `uninstall.ps1` 的最新正式发布资产；两个脚本默认只卸载当前项目，不会先升级或删除电脑全局命令。
+
+```bash
+# macOS / Linux 旧版本项目卸载
+curl -fsSL https://github.com/yuzyf/workflow_loop/releases/latest/download/uninstall.sh | bash
+```
+
+```powershell
+# Windows PowerShell 5.1 / 7 旧版本项目卸载
+powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://github.com/yuzyf/workflow_loop/releases/latest/download/uninstall.ps1 | iex"
+```
 
 ## 最小使用示例
 
@@ -98,9 +153,10 @@ powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://github.com/y
 之后由 AI 编码助手执行日常流程：
 
 1. 自动运行 `workflow start` 检查当前状态，并根据事实与用户确认本轮工作意图。
-2. 严格执行每条命令输出的“下一步”，每次只向用户确认一个问题。
-3. 在写代码前完成需求、验收、测试和实施计划，在受保护的回退基线上实施修改。
-4. 使用机器记录完成测试，经过主题验收和最终全量回归后正式收工。
+2. 调查现状并推荐四种路线之一，用户确认进入该任务后才启动轮次。
+3. 严格执行每条命令输出的“下一步”，讨论时每次只问用户一个问题。
+4. 完整研发路线在写代码前完成需求、验收、测试和实施计划；无需开发任务在用户确认讨论完毕后直接执行约定内容。
+5. 把真实结果交给用户核对并确认，再正式收工。
 
 用户不需要手工执行日常 `workflow` 命令；用户只负责描述需求、回答讨论问题、确认安装范围和确认各环节结果。
 
@@ -110,8 +166,11 @@ powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://github.com/y
 
 | 命令 | 中文含义 |
 |---|---|
-| `workflow start` | 检查当前轮次；没有进行中的工作时列出三种工作意图 |
-| `workflow start --intent <intent>` | 用指定工作意图开始一轮；`<intent>` 表示 `from_scratch`、`product_change` 或 `bugfix` |
+| `workflow start` | 检查当前轮次；没有进行中的工作时列出四种工作意图 |
+| `workflow start --intent <intent>` | 用户确认路线后开始一轮；`<intent>` 表示 `from_scratch`、`product_change`、`bugfix` 或 `light_task` |
+| `workflow light --discuss-done --task <任务> --verification <方法>` | 记录无需开发任务已讨论完毕；`<任务>` 是约定范围，`<方法>` 是结果核对方法 |
+| `workflow light --approve-action <准确操作>` | 记录用户单独批准的一项难撤销操作，只记录批准，不自动执行 |
+| `workflow light --confirmed --result <实际结果>` | 记录用户已经核对无需开发任务的真实结果 |
 | `workflow discuss` | 加载当前环节必须遵守的模板、规范和项目材料 |
 | `workflow gate <stage> --discuss-done` | 通过当前环节的讨论完成门；`<stage>` 表示当前环节标识 |
 | `workflow gate <stage>` | 让程序检查当前环节的文件、结构和可验证事实 |
@@ -120,8 +179,12 @@ powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://github.com/y
 | `workflow test ...` | 登记统一测试入口、准备测试项或执行受控测试 |
 | `workflow acceptance ...` | 记录需要用户判断的主题验收回答 |
 | `workflow return --to <stage> --reason <reason>` | 带具体原因退回上游环节，并使受影响的下游结果失效；`<reason>` 表示退回原因 |
-| `workflow abort` | 作废当前整轮，并按回退清单恢复受管内容 |
+| `workflow abort` | 作废完整研发轮次，并按回退清单恢复受管内容 |
+| `workflow abort --summary <真实状态>` | 作废无需开发任务，保留已发生状态并记录实际完成、未执行或失败内容 |
 | `workflow done` | 在最后一个环节确认后记录整轮完成并清理临时回退副本 |
+| `workflow update [--version <version>]` | 更新电脑全局命令和当前项目；`<version>` 表示可选的目标正式版本 |
+| `workflow uninstall` | 不管当前轮次状态，强制删除当前项目固定的 Workflow Loop 管理内容 |
+| `workflow uninstall --global` | 只卸载电脑全局 Workflow Loop 命令和来源明确的 PATH 项，不扫描项目 |
 
 可运行 `workflow --help` 查看当前版本提供的完整参数。
 
@@ -152,6 +215,10 @@ workflow_loop/
 ├── impl/                  实施计划与实施记录
 ├── install.sh             macOS 和 Linux 安装脚本
 ├── install.ps1            Windows 安装脚本
+├── update.sh              macOS 和 Linux 旧版本更新脚本
+├── update.ps1             Windows 旧版本更新脚本
+├── uninstall.sh           macOS 和 Linux 旧版本卸载脚本
+├── uninstall.ps1          Windows 旧版本卸载脚本
 ├── CONTEXT.md             产品术语、规则和限制
 └── DESIGN.md              实现设计文档
 ```
@@ -160,6 +227,9 @@ workflow_loop/
 
 - [产品总说明](spec/产品总说明.md)：产品目的、范围、使用者和通用规则。
 - [安装到项目](spec/功能_安装到项目.md)：支持环境、安装行为、异常处理和公开发布要求。
+- [更新已安装项目](spec/功能_更新已安装项目.md)：目标版本、覆盖范围、保留范围和失败重试规则。
+- [卸载 Workflow Loop](spec/功能_卸载_Workflow_Loop.md)：项目强制卸载和电脑全局卸载的独立边界。
+- [处理无需开发任务](spec/功能_处理无需开发任务.md)：简单流程适用边界、逐项确认、完成和异常处理规则。
 - [代码架构设计](spec/代码架构设计.md)：功能到代码模块、状态和外部依赖的对应关系。
 - [实现设计文档](DESIGN.md)：命令、数据模型、工作意图、阶段路径和门禁的实现形态。
 - [产品事实与约束](CONTEXT.md)：当前有效的术语、约束和设计决策。

{workflow_loop-0.1.0 → workflow_loop-0.2.0}/pyproject.toml

@@ -1,13 +1,13 @@
 [project]
 name = "workflow-loop"
-version = "0.1.0"
+version = "0.2.0"
 description = "为 AI 驱动的软件开发提供有状态、可验证、可回退的工作流管理。"
 readme = "README.md"
 requires-python = ">=3.11"
 license = "MIT"
 license-files = ["LICENSE"]
 authors = [{ name = "yuzyf" }]
-dependencies = []
+dependencies = ["packaging>=24.0"]
 
 [project.scripts]
 workflow = "workflow_loop.cli:main"

{workflow_loop-0.1.0 → workflow_loop-0.2.0}/src/workflow_loop/__init__.py

@@ -1,6 +1,6 @@
 # 包版本号，用于 pip/uv 安装时版本匹配
-__version__ = "0.1.0"
+__version__ = "0.2.0"
 # 产品身份标识：workflow --version 输出、安装脚本身份核对和安装事务校验共用同一组常量
-# 本次发布版本为 0.1.0；后续发布使用尚未被 PyPI 占用的新版本号
+# 本次发布版本为 0.2.0；后续发布使用尚未被 PyPI 占用的新版本号
 PRODUCT_NAME = "workflow-loop"
 PRODUCT_IDENTITY = f"{PRODUCT_NAME} {__version__}"