sansheng-liubu 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Twotwo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/LITE_DEV_WORKFLOW_SPEC.md

@@ -0,0 +1,292 @@
+# 极简高质 AI 研发工作流系统设计规范 (Lite-Agent SDLC Spec)
+
+> **版本**：v1.2 (全要素终极正式规范)  
+> **设计目标**：兼顾**高质量项目交付**、**极致精简流程（无形式主义）**与**极致节省 Token**，跨环境通用（Qoder / Antigravity / DeepSeek Harness / VS Code Copilot）。  
+> **技术栈适配**：深度适配 Vue 3 + Element Plus/UI + C# / .NET 8 / .NET Core 3.1 + HTML/JS/JSON/XML。
+
+---
+
+## 目录
+1. [核心大前提与设计原则](#一-核心大前提与设计原则)
+2. [跨环境通用架构：文件即协议](#二-跨环境通用架构文件即协议)
+3. [大项目滑动窗口分片与两级归档机制](#三-大项目滑动窗口分片与两级归档机制)
+4. [专属技术栈工具链适配矩阵 (Vue3 + .NET)](#四-专属技术栈工具链适配矩阵-vue3--net)
+5. [验收标准与质量门禁模块规范 (Quality Gates)](#五-验收标准与质量门禁模块规范-quality-gates)
+6. [交互式 UAT 逐项验收与即时自愈复盘闭环](#六-交互式-uat-逐项验收与即时自愈复盘闭环)
+7. [永乐大典双向知识复利闭环](#七-永乐大典双向知识复利闭环)
+8. [AST 代码拓扑映射、LSP 原生重构与极致压榨](#八-ast-代码拓扑映射lsp-原生重构与极致压榨)
+9. [防漏需求与细节溯源机制](#九-防漏需求与细节溯源机制)
+10. [边界铁律契约与测试守门员机制](#十-边界铁律契约与测试守门员机制)
+11. [需求锚定式质询规范](#十一-需求锚定式质询规范)
+12. [选项梯度与三态决策输入模型](#十二-选项梯度与三态决策输入模型)
+13. [非阻塞 Markdown 优先原则（消灭弹窗中断）](#十三-非阻塞-markdown-优先原则消灭弹窗中断)
+14. [全局插话回溯与涟漪影响分析](#十四-全局插话回溯与涟漪影响分析)
+15. [细粒度四级语义权限矩阵](#十五-细粒度四级语义权限矩阵)
+16. [纯净上下文隔离与 Subagent 执行机制](#十六-纯净上下文隔离与-subagent-执行机制)
+17. [抽象角色模型路由与弹性自愈升配](#十七-抽象角色模型路由与弹性自愈升配)
+18. [Token 经济学与上下文卫生控制](#十八-token-经济学与上下文卫生控制)
+19. [模块耦合与联动拓扑机制](#十九-模块耦合与联动拓扑机制)
+20. [保护人类心流的敏捷交互规范](#二十-保护人类心流的敏捷交互规范)
+21. [极简三阶段推进模型](#二十一-极简三阶段推进模型)
+
+---
+
+## 一、 核心大前提与设计原则
+
+1. **质量底线（Quality First）**：
+   - 深入剖析复杂需求文档，不遗漏任何业务细节与边界。
+   - 必须在开发计划中设立明确、可自动化的**专属验收标准与质量门禁模块（Quality Gates）**，杜绝自嗨。
+2. **流程精简（Zero Ceremonies）**：
+   - 坚决砍掉一切形式主义（多层冗余嵌套、复杂的中间态垃圾文件、无意义汇报）。
+   - 做必要的事，不做多余的事。拒绝把实现废话堆砌给人类。
+3. **极致省 Token（Token Hygiene）**：
+   - 杜绝长对话上下文污染，防止模型因注意力稀释导致智商下降。
+   - 过程问答会话即时蒸馏，落地为状态文件后即刻丢弃，执行阶段保持纯净。
+4. **跨 IDE 通用（Universal Portability）**：
+   - 不绑死特定 IDE 专有闭源插件，以标准 Markdown 协议 + 文件状态机为核心，在 Qoder、Antigravity、DeepSeek Harness、VS Code Copilot 表现一致。
+
+---
+
+## 二、 跨环境通用架构：文件即协议
+
+以项目根目录单一状态文件（如 `TASK.md`）作为人机协同的**唯一真理源**与**断点恢复锚点**。
+
+```
+                    ┌──────────────────────────────────────────────┐
+                    │   TASK.md (项目根目录的唯一真理源与进度板)   │
+                    └──────────────────────┬───────────────────────┘
+                                           │
+          ┌────────────────────────────────┼────────────────────────────────┐
+          ▼                                ▼                                ▼
+  【阶段 1: ALIGN】               【阶段 2: PLAN】                 【阶段 3: RUN】
+   需求剖析 / 锚点质询             边界契约 / 门禁标准 / 任务列表    单步执行 / 跑全量门禁 / 打勾
+ (不写代码，只做对齐)            (每个 Task 挂载 RULE 与断言)       (UAT逐项验收绿了才算交付)
+```
+
+---
+
+## 三、 大项目滑动窗口分片与两级归档机制
+
+解决大项目中 `TASK.md` 膨胀导致工具截断（800行限制）、行号错位与性能衰减的顽疾。
+
+```
+ ┌─────────────────────────────────────────────────────────────┐
+ │ 🗺️ ROADMAP.md (项目总纲 - 30行极简概览，不写代码实现细节)    │
+ │   - Phase 1: 核心流式导出与队列 (5个Task) ➔ [已完工 ✅]      │
+ │   - Phase 2: 复杂多租户权限与脱敏 (6个Task) ➔ [当前活跃 🔥] │
+ │   - Phase 3: 监控大屏与运维重试 (4个Task) ➔ [待启动 ⏳]    │
+ └──────────────────────────────┬──────────────────────────────┘
+                                │ (当前只把 Phase 2 载入滑动窗口)
+                                ▼
+ ┌─────────────────────────────────────────────────────────────┐
+ │ 🎯 TASK.md (当前活跃窗口 - 永远强制控制在 100~150 行以内!)    │
+ │   - 只装载当前正在攻坚的 Phase 2 的具体任务与门禁           │
+ └──────────────────────────────┬──────────────────────────────┘
+                                │ (UAT 验收全部通过后)
+                                ▼
+ ┌─────────────────────────────────────────────────────────────┐
+ │ 📁 两级自动化归档模型 (Archiving Protocol)                    │
+ │ ├── 1. 阶段滑动归档: TASK.md 移入 .tasks/archive/ 并刷新下一阶段│
+ │ └── 2. 项目结项全量归档: 经验同步永乐大典 ➔ 清理临时文件 ➔ 仓库纯净│
+ └─────────────────────────────────────────────────────────────┘
+```
+
+1. **滑动窗口铁律**：`TASK.md` 永远只装载当前活跃 Phase，物理上限严格控制在 **150 行以内**，彻底消灭工具截断。
+2. **阶段滑动归档（Phase Archiving）**：Phase 验收完成后自动归档为 `.tasks/archive/phase-xx.md`，无缝载入新 Phase。
+3. **结项全量归档（Milestone Close）**：输入 `archive` 或 `结项`，自动将全部经验同步至《永乐大典》，清理中间临时文件，移除 `TASK.md`，使生产代码仓库恢复 100% 原生纯净。
+
+---
+
+## 四、 专属技术栈工具链适配矩阵 (Vue3 + .NET)
+
+针对 **Vue 3 + Element Plus/UI + C# / .NET 8 / .NET Core 3.1 + HTML/JS/JSON/XML** 组合的专属落地工具矩阵：
+
+```
+ ┌─────────────────────────────────────────────────────────────┐
+ │        针对【Vue 3 + .NET 8 / Core 3.1】的专属工具矩阵      │
+ └──────────────────────────────┬──────────────────────────────┘
+                                │
+        ┌───────────────────────┴───────────────────────┐
+        ▼                                               ▼
+ 【前端: Vue 3 + Element Plus/UI】           【后端: C# / .NET 8 / Core 3.1】
+ ├── AST 映射: tree-sitter-vue (Aider)      ├── AST 映射: tree-sitter-c-sharp (Aider)
+ ├── LSP 重构: Volar (vue-language-server)  ├── LSP 重构: Roslyn / OmniSharp / csharp-ls
+ ├── 格式化: Biome / Prettier (0 Token)     ├── 格式化: CSharpier / dotnet format (0 Token)
+ └── 测试门禁: Vitest / Jest (组件与函数)   └── 测试门禁: dotnet test (xUnit / NUnit)
+```
+
+---
+
+## 五、 验收标准与质量门禁模块规范 (Quality Gates)
+
+在 `TASK.md` 中强制建立**专属质量门禁专区**：
+
+```markdown
+## 🎯 验收标准与质量门禁 (Verification & Quality Gates)
+
+### 1. 自动化单元测试门禁 (.NET & Vue3)
+- [ ] 运行 `dotnet test --verbosity quiet`，所有 xUnit/NUnit 测试 100% 绿灯 (0 Failed, 0 Error)。
+- [ ] 运行 `npx vitest run`（若包含前端单元测试），测试通过率 100%。
+
+### 2. 边界铁律反例用例清单 (Boundary Test Cases)
+- [ ] `[RULE-01]` 权限与租户隔离测试用例通过
+- [ ] `[RULE-02]` 阈值熔断与限流异常测试用例通过
+- [ ] `[RULE-03]` 异常锁释放与失败补偿测试用例通过
+- [ ] `[RULE-04]` 敏感数据脱敏测试用例通过
+
+### 3. 一键端到端冒烟命令 (One-Line Smoke Command)
+```bash
+dotnet test --filter "Category=IntegrationTest"
+```
+
+### 4. 人工 UAT 交付验收准则清单 (Human Sign-off Checklist)
+- [ ] `[UAT-01]` 进入 Vue 3 列表页，点击 Element `<el-button>` 异步导出，1秒内弹出 `<el-message>` 成功提示。
+- [ ] `[UAT-02]` 超过 100 万行导出时，后端正确拦截并向前端返回 4001 友好错误码。
+- [ ] `[UAT-03]` 下载中心生成直链，下载的 Excel 打开无乱码，脱敏字段显示正常。
+```
+
+---
+
+## 六、 交互式 UAT 逐项验收与即时自愈复盘闭环
+
+```
+ ┌─────────────────────────────────────────────────────────────┐
+ │ 🎯 弹出当前验收项 [UAT-01: 验证 100 万行导出熔断提示]       │
+ └──────────────────────────────┬──────────────────────────────┘
+                                │
+         ┌──────────────────────┴──────────────────────┐
+         ▼                                             ▼
+  【选项 1: ✅ Passed】                         【选项 2: ❌ Not Passed】
+         │                                             │ (附带输入缺陷现象)
+         │                                             ▼
+         │                                      ┌──────────────────────────────┐
+         │                                      │ AI 立即行动:                 │
+         │                                      │ 1. 定位源码与补写复现用例    │
+         │                                      │ 2. 修复 Bug 并跑通自动化测试 │
+         │                                      │ 3. 原地重新弹出 UAT-01 弹窗  │
+         │                                      └──────────────┬───────────────┘
+         │                                                     │ (用户复测通过)
+         ▼                                                     ▼
+ ┌─────────────────────────────────────────────────────────────────────────────┐
+ │ 1. 在 TASK.md 中标记: - [x] UAT-01: Passed                                  │
+ │ 2. 💡 (若经历过修复) 自动触发 yongle-postmortem 归档《排查与修复经验》至知识库 │
+ │ 3. 自动推进弹出下一个: [UAT-02: ...] ➔ 直到全部 All Passed!                  │
+ └─────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 七、 永乐大典双向知识复利闭环
+
+1. **开工前：前置静默召回（Pre-flight Recall）**：在 `ALIGN` 阶段，静默检索《永乐大典》中与当前技术栈相关的历史踩坑笔记与规范，直接作为质询与边界制定的输入。
+2. **完工后：后置自动提炼（Post-flight Distillation）**：任务验收通过后，自动从代码 Diff 和测试调试过程中提炼高价值新踩坑点，一键调用 `yongle-postmortem` 归档。
+
+---
+
+## 八、 AST 代码拓扑映射、LSP 原生重构与极致压榨
+
+1. **AST 代码骨架映射**：利用 `tree-sitter` 提取类名、方法签名（压缩率 95%+），工兵模型先行探路精确定位改动行号。
+2. **LSP 符号级原生重构**：重命名与跨文件重构走 LSP 原生指令（0 Token，毫秒级完成且保证编译正确）。
+3. **本地格式化与 Diff 块替换**：代码风格交由 `dotnet format` / `biome`，业务修改仅输出局部 Hunk Patch。
+
+---
+
+## 九、 防漏需求与细节溯源机制
+
+- 原子需求提取清单（`[REQ-01]`, `[REQ-02]`...）。
+- 需求跟踪矩阵（每个 Task 显式绑定 `[REQ-xx]`，100% 覆盖率对账）。
+
+---
+
+## 十、 边界铁律契约与测试守门员机制
+
+- 高密度边界铁律清单（`[RULE-xx]`）。
+- 任务级精准硬绑定注入。
+- 边界反例单元测试守门员（全绿才准出）。
+
+---
+
+## 十一、 需求锚定式质询规范
+
+- 四要素提问格式（📍坐标 + 📝微引用 + 🔍疑点分析 + 💡推荐选项）。
+- 阅读透视概览统计（阅读证明）。
+
+---
+
+## 十二、 选项梯度与三态决策输入模型
+
+- 梯度选项：简单 2 项、中等 2~3 项、重大决策 3~4 项。
+- 三态极简语法：组合（`A+B`）、纠结决裁（`纠结 A/B`）、阶段演进（`先 B 后 A`）。
+
+---
+
+## 十三、 非阻塞 Markdown 优先原则（消灭弹窗中断）
+
+- 零阻塞 Tool 铁律：对齐阶段严禁调用阻塞型表单弹窗，全面采用流式 Markdown。
+- 完全无锁：随时打字输入，永不触发中断异常。
+
+---
+
+## 十四、 全局插话回溯与涟漪影响分析
+
+- 全局无阻碍回溯：随时输入 `修改 Qx 为 ...` 优先响应。
+- 决策变更涟漪分析：底层决策变更时，AI 自动扫描受影响节点并提示联动调整。
+- 动态决策看板：`TASK.md` 实时记录决策状态。
+
+---
+
+## 十五、 细粒度四级语义权限矩阵
+
+* 🟢 **Level 1 (只读探索)**：`view_file`, `grep`, `ls` ➔ 100% 静默放行。
+* 🟡 **Level 2 (验证测试)**：`dotnet test`, `vitest`, `eslint` ➔ 100% 自动执行。
+* 🟠 **Level 3 (工作区改写)**：当前仓库源码修改 ➔ 自动放行 + Git 保护。
+* 🔴 **Level 4 (高危不可逆)**：`rm -rf`, `git push -f`, 删库, 越界路径 ➔ 强制人工确认。
+
+---
+
+## 十六、 纯净上下文隔离与 Subagent 执行机制
+
+- 会话断代：对齐结束后信息固化进 `TASK.md`，执行阶段采用纯净上下文（1~2k Token）。
+- 跨环境适配：支持 Subagent 则后台派生独立 Worker；单会话 IDE 则新开对话输入 `继续 TASK.md`。
+
+---
+
+## 十七、 抽象角色模型路由与弹性自愈升配
+
+- 🧠 **Tier-1 (旗舰深推理大脑)**：负责需求对齐、架构设计与门禁生成。
+- 👷 **Tier-2 (极速高吞吐工兵)**：负责单任务纯净编码与测试，成本直降 90%。
+- 🚨 **弹性自愈升配**：Tier-2 连续 2 次测试失败时，自动召唤 Tier-1 接管调试。
+
+---
+
+## 十八、 Token 经济学与上下文卫生控制
+
+- 微引用（单次提问 < 100 Token）。
+- 会话蒸馏与丢弃（执行阶段丢弃 Q&A 历史）。
+- 单任务精准上下文（结合 AST 骨架按需精准读文件）。
+
+---
+
+## 十九、 模块耦合与联动拓扑机制
+
+- 模块三色分类（🟢 独立 / 🟡 依赖 / 🔴 强联动）。
+- 极简副作用与联动清单（Cross-Module Trigger Map）。
+
+---
+
+## 二十、 保护人类心流的敏捷交互规范
+
+- 堆栈式动态下钻（想聊立即深聊，其余自动挂起，定稿后主动唤醒）。
+- 消灭废话握手（绝不反问“你想聊什么”，直接给出两难对比）。
+- 快慢混合单行输入（一行搞定快选 + 深入抛梗）。
+
+---
+
+## 二十一、 极简三阶段推进模型
+
+1. **`ALIGN` 阶段 (Tier-1 大脑 + 永乐大典前置召回)**：
+   - 知识库历史经验静默检索 ➔ 需求原子化提取 ➔ 锚点质询 ➔ 提炼边界铁律 `[RULE-xx]`。
+2. **`PLAN` 阶段 (Tier-1 大脑 + AST 骨架分析)**：
+   - 依赖拓扑分析 ➔ **生成专属质量门禁与 UAT 清单** ➔ 拆分 Task 列表（严格控制在 150 行以内） ➔ 3 行极简 HUD。
+3. **`RUN` 阶段 (Tier-2 工兵 + LSP 原生重构 + 交互式 UAT + 永乐大典即时沉淀)**：
+   - 纯净上下文执行 Task ➔ 精准块改动/LSP 重构 ➔ 跑通 `dotnet test` / `vitest` ➔ **交互式 UAT 逐项验收与自愈修复** ➔ 验收通过即时提炼经验归档至《永乐大典》 ➔ **两级自动归档 (Phase 滑动 / 结项纯净化)**。

package/README.md

@@ -0,0 +1,176 @@
+# 🏛️ 三省六部 (sansheng-liubu)
+
+> 基于中国古代「三省六部制」的极简高质跨环境 AI 研发工作流系统  
+> **核心定位**：高质量交付 + 去形式主义（羽量级） + 极致节省 Token（降幅 85%+）  
+> **深度适配**：Vue 3 + Element Plus/UI + C# / .NET 8 / .NET Core 3.1 + HTML/JS/JSON/XML
+
+---
+
+## ⚡ 三大零摩擦调用方式
+
+### 1. 零前缀自然语言自感知 (Zero-Prefix)
+再也不需要输入死板的括号标签！AI 自动根据工作区状态识别意图：
+* 丢入需求 ➔ 自动启动【中书省 ALIGN】
+* 回复决策 ➔ 自动启动【门下省 PLAN】
+* 喊一句“继续/开跑” ➔ 自动进入【尚书省 RUN】
+
+### 2. 统一斜杠指令 (`/sansheng`)
+在 IDE 聊天框中输入 `/sansheng [内容]` 即可驱动全流程：
+```
+/sansheng 帮我把所有列表页做异步导出重构
+/sansheng map   # 重新生成项目 AST 骨架图
+```
+
+### 3. 极速单字符快捷交互 (Shorthand)
+* `c` / `r` ➔ 全自动执行全部任务与测试 (continue/run)
+* `s` / `n` ➔ 单步推进当前任务并汇报 (step/next)
+* `1` / `y` ➔ 交互式 UAT 判定通过 (Passed)
+* `2 报错描述` ➔ 交互式 UAT 判定未通过，工兵原地自愈修复
+* `archive` / `结项` ➔ 触发两级项目归档与永乐大典同步
+
+---
+
+## 🛠️ VS Code + GitHub Copilot 专属深度增强
+
+针对主要使用 **VS Code + GitHub Copilot** 的开发者，`sansheng-liubu` 在 `sansheng init` 时会自动注入 **四大专属原生增强套件**：
+
+```
+ ┌─────────────────────────────────────────────────────────────┐
+ │           🏆 sansheng-liubu 针对 VS Code Copilot 专属增强    │
+ └──────────────────────────────┬──────────────────────────────┘
+                                │
+   ┌────────────────┬───────────┴────────┬────────────────┐
+   ▼                ▼                    ▼                ▼
+【1. 指令文件注入】 【2. 原生 MCP 工具】 【3. Prompt 模板】 【4. VS Code Tasks】
+.github/copilot-   .vscode/mcp.json     .github/prompts/  .vscode/tasks.json
+instructions.md    打通 CBM 15个工具     一键唤醒 /sansheng 快捷键一键跑测试/骨架
+每句对话自动注入    Copilot 直接查调用链  VS Code 原生斜杠   无需手动切终端敲命令
+```
+
+1. **自动注入 `.github/copilot-instructions.md`**：Copilot 每轮对话自动遵循三省六部极简高质铁律（消灭长篇刷屏，强制 3 行 HUD）；
+2. **自动生成 `.vscode/mcp.json`**：将 `codebase-memory-mcp` 直接挂进 VS Code，Copilot 聊天框可原生调用 `get_architecture`、`trace_path` 等 15 个工具；
+3. **原生 Prompt 模板 (`.github/prompts/sansheng.prompt.md`)**：VS Code Copilot 聊天框输入 `/sansheng` 即可一键唤醒自感知工作流；
+4. **快捷自动化任务 (`.vscode/tasks.json`)**：按 `Ctrl+Shift+P` ➔ 运行任务一键跑骨架提取与质量门禁测试。
+
+---
+
+## 📦 一键安装与环境配置指南
+
+三省六部原生深度整合了 **微观编译器 (LSP)** 与 **宏观知识图谱 (CBM)** 双引擎，建议在开发机上一键安装好全套底座：
+
+```
+ ┌─────────────────────────────────────────────────────────────┐
+ │                🏆 三省六部“双引擎”代码智能体系               │
+ └──────────────────────────────┬──────────────────────────────┘
+                                │
+        ┌───────────────────────┴───────────────────────┐
+        ▼                                               ▼
+【微观层: csharp-ls (LSP 编译器)】           【宏观层: CBM (知识图谱 MCP)】
+─────────────────────────────────           ─────────────────────────────────
+• 0-Token 原生跨文件原子重命名                • `get_architecture`: 秒级透视分层与入口
+• 100% 官方 Roslyn 语法与类型诊断             • `trace_path`: 双向追踪 10 层调用链
+• 0 毫秒精准跳转接口实现类                   • `detect_changes`: 评估 Git 改动爆炸半径
+```
+
+### 1. 全局安装三省六部核心引擎
+```bash
+npm install -g sansheng-liubu
+```
+
+### 2. 安装 C# / .NET 官方语言服务器 (LSP 编译器微观精度)
+```bash
+dotnet tool install -g csharp-ls
+```
+
+### 3. 安装 CBM 知识图谱引擎 (宏观架构与 15 个 MCP 工具)
+```bash
+npm install -g codebase-memory-mcp
+```
+*(Windows PowerShell 也可直接运行官方脚本: `Invoke-WebRequest -Uri https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.ps1 -OutFile install.ps1; Unblock-File .\install.ps1; .\install.ps1`)*
+
+### 4. 安装 Vue 3 前端语言服务器 (可选)
+```bash
+npm install -g @vue/language-server
+```
+
+### 5. 一键自检全套代码智能环境
+在终端任意目录下运行：
+```bash
+sansheng init
+# 或单独验证 LSP 协议:
+npm run test:lsp
+```
+
+---
+
+## 🚀 现有项目（Existing Projects）快速接入实战指南
+
+当环境安装完成后，对于你本地已有的真实业务项目（如 `D:\...\02.CatFoodManager`），仅需 **3 步** 即可无缝激活全套体系：
+
+### 步骤 1：进入已有项目根目录并初始化
+```bash
+cd "D:\your-existing-project"
+sansheng init
+```
+👉 **CLI 会全自动完成环境对账并自动注入 VS Code / Copilot 增强**！
+
+### 步骤 2：建立项目代码地图与 CBM 知识图谱（双擎初始化）
+```bash
+# 1. 提取 AST 纯文本代码符号骨架 (生成 .codebase_map.md，Token 物理压缩 95%+)
+sansheng map
+
+# 2. 为项目构建 CBM 知识图谱数据库 (秒级解析全局类节点、函数节点与调用链边)
+codebase-memory-mcp cli index_repository
+```
+> 💡 **可选：打开浏览器看 3D 图谱**：  
+> 运行 `codebase-memory-mcp --ui=true`，浏览器访问 `http://localhost:9749` 即可 3D 旋转查看调用拓扑！
+
+### 步骤 3：在 AI IDE 中直接对话开发（双擎协同流）
+在 VS Code Copilot / Antigravity / Qoder 对话框中，**直接用大白话输入需求**：
+1. **中书省 ALIGN**：*“我想给 CatFoodManager 加个库存预警定时任务”* ➔ AI 结合 CBM 图谱与骨架秒级透视分层，精准提问与提炼铁律；
+2. **门下省 PLAN**：回复 *“1A 2B 3A”* ➔ AI 自动生成带 `dotnet test` 门禁的 `TASK.md`（聊天框仅回显 3 行 HUD）；
+3. **六部 RUN**：回复 *“c”* ➔ AI 调用 `csharp-ls` 纯净编写代码，跑通全部测试；
+4. **UAT 自愈**：AI 弹出单项验收，如遇 Bug 回复 *“2 描述”* ➔ 原地写用例修复并复测，通过后自动沉淀心得至《永乐大典》；
+5. **结项归档**：回复 *“archive”* ➔ 两级自动归档，代码仓库恢复 100% 纯净。
+
+---
+
+## 🗺️ Codebase Mapping (AST 代码骨架拓扑提取原理)
+
+针对庞大老工程，传统 AI 往往盲读几万行源码导致 **Token 瞬间爆炸并引发上下文截断**。  
+`sansheng-liubu` 原生内置了基于 **AST 语法树的轻量代码拓扑提取器**：
+
+* **C# / .NET**：秒级遍历解析 `.cs` 源码，提取命名空间、`class` / `interface` 声明、方法入参签名与特性注解，**彻底剥离函数体 `{ ... }` 细节**；
+* **Vue 3 SFC**：精准提取 `<script setup>` 内的 `defineProps`、`defineEmits`、`defineExpose` 与核心函数签名；
+* **实测效果**：**Token 物理压缩率超过 95%**！把几万行的复杂工程压缩成一张仅占 1~2k Token 的超高密度架构符号图。
+
+一键提取命令：
+```bash
+sansheng map
+```
+*自动在项目根目录生成 `.codebase_map.md`。*
+
+---
+
+## 💾 数据持久化与存储位置说明
+
+* **项目 AST 骨架图**：直接保存在项目根目录的 [`.codebase_map.md`](.codebase_map.md)（透明 Markdown 纯文本）；
+* **CBM 知识图谱数据库**：持久化保存在本地物理固态硬盘 `~/.cache/codebase-memory-mcp/`（SQLite `.db` 磁盘文件，**电脑重启绝不丢失**）。
+
+---
+
+## 🛠️ CLI 常用命令集
+
+| 命令 | 描述 |
+| :--- | :--- |
+| `sansheng init` | 初始化当前工作区三省六部配置（自动注入 Copilot 增强 / 探测 LSP 与 CBM） |
+| `sansheng update` | 检查最新版本、无损增量同步工作区配置与 IDE 技能规则 |
+| `sansheng map` | 提取当前项目 AST 符号骨架地图 (`.codebase_map.md`) |
+| `sansheng status` | 极简查看当前活跃 Phase 进度 HUD |
+| `sansheng uat` | 启动交互式单项 UAT 验收与自愈修复循环 |
+| `sansheng archive` | 触发两级项目结项归档并同步至《永乐大典》 |
+
+---
+
+## 📄 详细架构白皮书
+完整 21 章节工业级设计白皮书详见：[`LITE_DEV_WORKFLOW_SPEC.md`](./LITE_DEV_WORKFLOW_SPEC.md)

package/SKILL.md

@@ -0,0 +1,73 @@
+---
+name: sansheng-liubu
+description: 基于「三省六部制」的极简高质跨环境 AI 研发工作流系统（中书省起草对齐 / 门下省门禁审核 / 尚书省调度六部工兵执行与两级归档）
+---
+
+# 三省六部 (Sansheng-Liubu) 研发工作流指令集
+
+你现在是基于中国古代「三省六部制」构建的特种作战研发智能体引擎。你的核心使命是兼顾**高质量项目交付**、**极致精简流程（无形式主义）**与**极致节省 Token**（深度适配 Vue 3 + .NET 8 / Core 3.1 技术栈）。
+
+---
+
+## ⚡ 三大零摩擦调用与交互模式（最高优先级原则）
+
+1. **零前缀自然语言自感知（Zero-Prefix Auto-Sensing）**：
+   - 用户无需输入任何 `[ALIGN]`、`[PLAN]` 等死板标签；
+   - 用户随口抛出需求（如 *“帮我把列表改成异步导出”*），AI 自动检测并启动 **中书省 (ALIGN)**；
+   - 用户输入 *“搞定”*、*“开跑”* 或 *“继续”*，AI 自动进入 **六部 (RUN)**。
+
+2. **统一斜杠指令（Unified Slash Command: `/sansheng`）**：
+   - 任何时候用户输入 `/sansheng [内容]`，AI 自动根据当前 `TASK.md` 的生命周期情境智能路由与推进。
+   - `/sansheng map` ➔ 立即为当前项目全量扫描并重新生成 `.codebase_map.md`。
+
+3. **极速单字符/缩写响应支持（Shorthand Mode）**：
+   - `c` (continue) / `r` (run) ➔ 尚书省全自动跑完所有任务与测试；
+   - `s` (step) / `n` (next) ➔ 尚书省单步推进当前任务并汇报；
+   - `1` / `y` (yes) ➔ 交互式 UAT 判定通过 (`Passed`)；
+   - `2 <缺陷描述>` ➔ 判定未通过，六部工兵**立即原地写复现用例、修复并重新复测**；
+   - `archive` / `结项` / `完工` ➔ 触发两级归档并同步《永乐大典》。
+
+---
+
+## 🏛️ 三省六部核心职能与流程定义
+
+### 1. 中书省 (Zhongshu) ➔ 【ALIGN 需求对齐阶段】(Tier-1 旗舰大脑)
+* **动作 0: 代码库拓扑感知 (Codebase Mapping)**：
+  - **自动前置触发**：若项目根目录不存在 `.codebase_map.md`，中书省在开工质询前**自动前置静默调用 `sansheng map`（或 `extractCodebaseMap`）**，秒级生成 AST 符号地图，依据骨架图开展精准提问，杜绝全量盲读源码；
+  - **显式指令触发**：当用户输入 *“扫一下项目”*、*“提取代码骨架”*、*“/sansheng map”* 时，立即全量更新 `.codebase_map.md`。
+* **动作 1: 前置召回**：静默检索《永乐大典》（`yongle-search`）中相关技术栈的历史踩坑经验。
+* **动作 2: 原子化提取**：将需求拆解为 `[REQ-01]`, `[REQ-02]`... 编号清单，拒绝遗漏任何细节。
+* **动作 3: 锚定式质询**：提出问题时必须遵守四要素格式：`📍 坐标` + `📝 微引用 (20字以内)` + `🔍 疑点分析` + `💡 推荐阶梯选项 (2~4项)`。
+* **动作 4: 敏捷交互响应**：
+  * 支持堆栈式下钻（用户想深入聊某题时立即展开，其余挂起，定稿后主动唤醒）；
+  * 零废话握手（严禁反问“你想聊什么”，直接给出两难方案对比）；
+  * 支持三态语法（`A+B` 组合分层、`纠结 A/B` 决裁矩阵、`先 B 后 A` 阶段演进）。
+* **动作 5: 提炼边界铁律**：提炼 3~5 条红线规则 `[RULE-01 ~ RULE-xx]`（杜绝平庸语法废话）。
+
+---
+
+### 2. 门下省 (Menxia) ➔ 【PLAN 计划与门禁阶段】(Tier-1 旗舰大脑)
+* **动作 1: 依赖拓扑分析**：标记模块三色分类（🟢 独立 / 🟡 顺序 / 🔴 强联动）与极简副作用表。
+* **动作 2: 建立专属质量门禁 (Quality Gates)**：
+  - 自动化单元测试门禁 (`dotnet test` / `npx vitest run` 100% 绿灯)。
+  - 边界反例用例清单 (`[RULE-xx]` 对应测试方法)。
+  - 一键端到端冒烟命令。
+  - 人工 UAT 交付清单 (`[UAT-01]` ...)。
+* **动作 3: 覆盖率对账**：自检所有 `[REQ-xx]` 是否 100% 被 Task 覆盖。
+* **动作 4: 生成 TASK.md**：将所有信息固化至 `TASK.md`（严格限制在 150 行以内），聊天窗口仅回显 3 行极简 HUD（绝不长篇刷屏）。
+
+---
+
+### 3. 尚书省与六部 (Shangshu & Liubu) ➔ 【RUN 执行与归档阶段】(Tier-2 极速工兵)
+* **动作 1: 纯净上下文派生**：通过子 Agent（`invoke_subagent`）或独立工兵进程执行单任务，仅携带当前 Task 与 1~2 个目标源码文件（0 历史 Token 负担）。
+* **动作 2: 极致物理压榨**：
+  - 符号重构调用 LSP 原生指令（0 Token 跨文件重命名）；
+  - 代码排版调用 `dotnet format` / `biome`，严禁让 LLM 消耗 Token 调缩进；
+  - 业务修改仅输出局部 Diff 块（`replace_file_content`）。
+* **动作 3: 弹性自愈升配**：工兵连续 2 次测试失败，自动召唤 Tier-1 旗舰大脑救火。
+* **动作 4: 交互式 UAT 逐项自愈**：
+  - 弹出单项验收卡片：`1 / Passed` ➔ 打勾；`2 / Not Passed` ➔ 原地写复现用例、修复并重新复测。
+  - 修复通过后，**即时触发 `yongle-postmortem` 将避坑心得归档至《永乐大典》**。
+* **动作 5: 两级自动归档**：
+  - 阶段完工：`TASK.md` 自动归档至 `.tasks/archive/`，载入新 Phase。
+  - 项目结项：执行 `archive`，经验全量同步《永乐大典》，清理临时文件，恢复仓库纯净。