npm - @geeseeker/easyai-dev - Versions diffs - 3.0.7 → 3.0.9 - Mend

@geeseeker/easyai-dev 3.0.7 → 3.0.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@geeseeker/easyai-dev",
-  "version": "3.0.7",
+  "version": "3.0.9",
   "description": "easyAI — 让用户以纯客户的视角进行软件开发",
   "type": "module",
   "bin": {

package/skeleton/.agents/skills/common-session-close/SKILL.md CHANGED Viewed

@@ -11,6 +11,7 @@ description: 会话收尾与日志沉淀 — 汇总本会话工作、写入 jour
 ## 触发条件
+- 用户明确表示「**收工**」（或等价表达，如"结束"、"下班"等）
 - 用户明确表示本次会话结束
 - 上下文预算接近阈值，需要新开会话
 - 任务执行完成，准备提交验收
@@ -60,12 +61,12 @@ task_append_log({
 2. **列出候选沉淀内容**
    - 向用户展示候选文档列表，说明每项的建议目标路径：
-   | Artifacts 类型 | 建议沉淀目标 |
-   |----------------|-------------|
-   | `walkthrough.md` | `.docs/notes/` 或 `.docs/guides/` |
-   | `other`（分析报告等） | `.docs/notes/` 或 `.docs/design/` |
+   | Artifacts 类型           | 建议沉淀目标                               |
+   | ------------------------ | ------------------------------------------ |
+   | `walkthrough.md`         | `.docs/notes/` 或 `.docs/guides/`          |
+   | `other`（分析报告等）    | `.docs/notes/` 或 `.docs/design/`          |
    | `implementation_plan.md` | 通常已由 `pm-brainstorm` Step 6 处理，跳过 |
-   | `task.md` | 不沉淀（`.trellis/tasks/` 已持久化） |
+   | `task.md`                | 不沉淀（`.trellis/tasks/` 已持久化）       |
 3. **用户确认后执行**
    - 用户确认需要沉淀 → 提炼内容并写入目标路径

package/skeleton/.agents/skills/pm-framework-evolve/SKILL.md CHANGED Viewed

@@ -9,15 +9,27 @@ description: PM 框架自迭代 — 框架百科查询、安全迭代、迭代
 PM 角色在以下场景**必须**激活本 Skill：
-1. **查询框架知识**：需要了解框架架构、功能、文件职责时 → 读取 `references/`
-2. **修改框架文件**：需要修改 `.agents/`、`.trellis/spec/`、`.trellis/config/` 时 → 执行安全迭代流程
-3. **查看迭代历史**：需要了解框架的修改记录时 → 读取 `changelog/`
+1. **查询框架知识**（最常用）：需要了解框架架构、功能、文件职责时 → 读取 `references/`
+2. **修改框架文件**：需要修改 `.agents/`、`.trellis/spec/`、`.trellis/config/` 时 → 执行迭代流程
+3. **查看迭代历史**：需要了解框架修改记录时 → 读取 `changelog/`
 > **实时性内容**（如最新 Issues、Release 历史）应由 AI 实时访问 GitHub 仓库获取，不写死在文件中。
+## 知识库（references/）
+框架的结构化知识，修改框架前**必须先查阅**：
+| 文件               | 内容                                                           |
+| ------------------ | -------------------------------------------------------------- |
+| `architecture.md`  | 设计理念、三层架构、约束分层、角色系统、文档沉淀管道、升级机制 |
+| `features.md`      | 10 Skills、3+1 Rules、21 Tools、6 Resources、关联关系图        |
+| `directory-map.md` | 完整目录清单，🦴骨架/🏃运行时/🔧开发专属分类                   |
+| `installation.md`  | 两种安装方式、安装后结构、版本管理、Manifest 智能合并          |
+| `github-info.md`   | 仓库地址、npm 包名、迭代历史查看方式                           |
 ## 管控范围
-以下 **框架核心目录** 的修改必须通过本 Skill 执行：
+以下 **框架核心目录** 的修改必须通过本 Skill 管控：
 - `.agents/rules/` — 规则文件
 - `.agents/workflows/` — 角色入口
@@ -26,10 +38,12 @@ PM 角色在以下场景**必须**激活本 Skill：
 - `.trellis/config/` — 框架配置
 > `.trellis/tasks/` 和 `.trellis/workspace/` 属于运行时数据，不受本 Skill 管控。
+>
+> **开发工作区注意**：在 `easyAI-dev/` 中，实际修改在 `playground/` 进行，记录用 `.trellis/`。详见 `framework-dev-mode.md` rule。
 ---
-## 安全迭代流程
+## 迭代流程
 ### Step 0：知识加载（前置）
@@ -44,119 +58,65 @@ PM 角色在以下场景**必须**激活本 Skill：
 列出所有将要修改的文件及变更类型：
 ```markdown
-## 框架变更清单
-| 文件 | 变更类型 | 变更摘要 |
-|------|----------|----------|
-| .agents/rules/xxx.md | 修改 | 增加 xxx 约束 |
-| .agents/skills/yyy/SKILL.md | 新建 | yyy 能力模块 |
+| 文件                        | 变更类型 | 变更摘要      |
+| --------------------------- | -------- | ------------- |
+| .agents/rules/xxx.md        | 修改     | 增加 xxx 约束 |
+| .agents/skills/yyy/SKILL.md | 新建     | yyy 能力模块  |
 ```
 ### Step 2：影响范围分析
-```markdown
-## 影响范围报告
-### 直接影响
-- 变更文件数：{n} 个
-- 变更类型：新建 / 修改 / 删除
+评估直接影响（变更文件数、变更类型）和间接影响（关联角色、关联 Skills、约束层级），给出风险等级：
-### 间接影响
-- 关联角色：{受影响的 PM / Worker 角色行为变更}
-- 关联 Skills：{依赖受影响文件的其他 Skills}
-- 约束层级：{是否影响约束优先级体系}
-### 风险等级
-- 低：仅新增能力，不影响现有行为
-- 中：修改已有文件，可能影响角色行为
-- 高：修改 Rules 或核心 Workflow，影响所有会话
-```
+- **低**：仅新增能力，不影响现有行为
+- **中**：修改已有文件，可能影响角色行为
+- **高**：修改 Rules 或核心 Workflow，影响所有会话
 ### Step 3：用户确认门
-将变更清单和影响范围报告呈现给用户，**等待明确确认后才执行写入**。
-**用户确认后**：
-1. 逐步执行变更
-2. 每步完成后验证文件完整性
+将变更清单和影响报告呈现给用户，**等待明确确认后才执行**。用户拒绝则记录原因到 journal，放弃变更。
-**用户拒绝**：
-- 放弃全部变更，保持原文件不动
-- 记录拒绝原因到 journal
+### Step 4：执行变更 + 验证
-### Step 4：执行变更 + 变更后验证
-- 执行文件修改
-- 检查修改后的文件是否格式完整、语法正确
+- 逐步执行文件修改，每步完成后验证完整性
 - 如涉及 MCP Server 代码，确保 `npm run build` 通过
-### Step 5：记录迭代（后置）
+### Step 5：记录迭代
 1. 按 `resources/changelog-entry-template.md` 模板生成迭代记录
 2. 保存到 `changelog/YYYY-MM-DD_{slug}.md`
 3. 更新 `changelog/index.md` 索引
 4. 通过 `journal_append()` 记录变更日志
-### Step 6：知识库自更新（后置）
+### Step 6：知识库自更新
-迭代完成后，检查 `references/` 中是否有文件被本次变更影响：
+迭代完成后，检查 `references/` 中是否有文件需要更新：
-- 新增了 Skill → 更新 `features.md`
-- 新增了 Rule → 更新 `features.md`
+- 新增/删除了 Skill → 更新 `features.md`
+- 新增/删除了 Rule → 更新 `features.md`
 - 修改了目录结构 → 更新 `directory-map.md`
 - 修改了安装功能 → 更新 `installation.md`
+- 修改了架构设计 → 更新 `architecture.md`
 > **自更新边界**：只更新事实性描述，不改变知识库的结构和格式。
 ---
-## 跨项目复用
-将本项目的框架修改应用到其他使用 easyAI 的项目：
-| 方式 | 说明 | 适用场景 |
-|------|------|----------|
-| 手动复制 | 根据 `changelog/` 记录，在另一个项目中手动应用 | 少量修改 |
-| Git Patch | changelog 中的 diff 可以作为 `git apply` 的输入 | 精确复制代码变更 |
-| 整体复制 | 复制整个 `.agents/` 和 `.trellis/config/` + `.trellis/spec/` | 全新项目初始化 |
----
 ## 迭代分类标签
-| 标签 | 定义 | 示例 |
-|------|------|------|
-| `新增` | 添加框架原本没有的全新功能 | 新增一个 Skill、新增一个 MCP Tool |
-| `优化` | 改善现有功能，不改变功能边界 | 优化 Skill 的流程步骤、改善错误提示 |
-| `修复` | 修正现有功能的 Bug 或文档错误 | 修复 tool 参数校验遗漏 |
-| `修改` | 调整现有功能的行为或配置，在设计走廊内 | 修改约束层级顺序、修改默认配置值 |
-| `魔改` | **超出设计意图**的深度改造 | 重写角色系统、替换 MCP 传输协议 |
-| `实验性` | 试探性修改，可能会被撤销 | 试验新的上下文管理策略 |
+| 标签     | 定义                                   | 示例                                |
+| -------- | -------------------------------------- | ----------------------------------- |
+| `新增`   | 添加框架原本没有的全新功能             | 新增一个 Skill、新增一个 MCP Tool   |
+| `优化`   | 改善现有功能，不改变功能边界           | 优化 Skill 的流程步骤、改善错误提示 |
+| `修复`   | 修正现有功能的 Bug 或文档错误          | 修复 tool 参数校验遗漏              |
+| `修改`   | 调整现有功能的行为或配置，在设计走廊内 | 修改约束层级顺序、修改默认配置值    |
+| `魔改`   | **超出设计意图**的深度改造             | 重写角色系统、替换 MCP 传输协议     |
+| `实验性` | 试探性修改，可能会被撤销               | 试验新的上下文管理策略              |
 > **修改 vs 魔改判断标准**：问"这个修改是否改变了框架对其他组件的**契约**？" 不改变契约 = 修改，改变契约 = 魔改。
 ---
-## PATEOAS 导航
-```markdown
-### 下一步行动
-1. [ ] 如查询知识 → 读取 `references/` 中对应文档回答用户
-2. [ ] 如框架变更 → 走 Step 0-6 完整流程
-3. [ ] 变更完成后 → 运行 `npm run build` 验证（如涉及代码）
-4. [ ] 使用 `/pm` 或 `/worker {task_id}` 继续后续任务
-### 状态快照
-- 当前阶段：FRAMEWORK_EVOLVE
-- 变更状态：{知识查询 / 已应用 / 已拒绝}
-- 变更文件数：{n} 个
-- 风险等级：{低/中/高}
-- 迭代记录：{已生成/不适用}
-- 知识库自更新：{已完成/不适用}
-```
 ## 硬约束
 - **必须经用户确认门**：禁止绕过确认直接修改框架文件

package/skeleton/.agents/skills/pm-framework-evolve/references/architecture.md CHANGED Viewed

@@ -25,27 +25,45 @@
 ├── design/       ← 设计文档（AI ↔ 用户）
 ├── guides/       ← 使用指南（AI → 用户）
 ├── notes/        ← 临时文档（用户 ↔ AI）
-└── archive/      ← 归档（各文件夹中作废/不再适配的历史文档）
-packages/         ← 可编程层
-└── mcp-server/   ← MCP Server（TypeScript）
+└── archive/      ← 归档
 ```
+> 用户通过 npm 包获得编译后的 MCP Server（TypeScript → JavaScript），源码位于开发工作区的 `packages/mcp-server/`。
 ## 约束分层体系（五级优先级）
 高层覆盖低层，冲突时上报用户：
-| 层级 | 类型 | 约束性 | 说明 |
-|------|------|--------|------|
-| 1 | Rules | 硬约束 | 反幻觉、编码规范 — 始终生效，不可覆盖 |
-| 2 | Skills | 硬约束 | TDD 流程、验证标记 — 角色激活时生效 |
-| 3 | MCP | 硬约束 | 状态机校验、Evidence Gate — 可编程硬约束 |
-| 4 | PM 判断 | 软约束 | 约束集、任务指令 — 可由用户裁决调整 |
-| 5 | 用户偏好 | 软约束 | 个人习惯 — 可被上层覆盖 |
+| 层级 | 类型     | 约束性 | 说明                                     |
+| ---- | -------- | ------ | ---------------------------------------- |
+| 1    | Rules    | 硬约束 | 反幻觉、编码规范 — 始终生效，不可覆盖    |
+| 2    | Skills   | 硬约束 | TDD 流程、验证标记 — 角色激活时生效      |
+| 3    | MCP      | 硬约束 | 状态机校验、Evidence Gate — 可编程硬约束 |
+| 4    | PM 判断  | 软约束 | 约束集、任务指令 — 可由用户裁决调整      |
+| 5    | 用户偏好 | 软约束 | 个人习惯 — 可被上层覆盖                  |
 ## 角色系统
-| 角色 | 触发方式 | 职责 |
-|------|----------|------|
-| PM | `/pm` | 需求沟通、任务管理、验收审批 |
-| Worker | `/worker` | 按约束集执行任务、自检产出 |
+| 角色   | 触发方式       | 职责                         |
+| ------ | -------------- | ---------------------------- |
+| PM     | `/pm`          | 需求沟通、任务管理、验收审批 |
+| Worker | `/worker T001` | 按约束集执行任务、自检产出   |
+## 文档沉淀管道
+会话中产生的 Artifacts（热记忆）通过 PM 审核后沉淀到 `.docs/`（持久文档空间）：
+| 来源                     | 沉淀目标                          | 触发时机                      |
+| ------------------------ | --------------------------------- | ----------------------------- |
+| `implementation_plan.md` | `.docs/design/`                   | `pm-brainstorm` 完成时        |
+| `walkthrough.md`         | `.docs/notes/` 或 `.docs/guides/` | `pm-task-review` Stage 3      |
+| 分析报告等               | `.docs/notes/` 或 `.docs/design/` | `common-session-close` Step 4 |
+## 升级机制
+框架通过 **Manifest 驱动的智能合并**升级：
+- `easyai-manifest.json` 记录 skeleton 中所有框架文件的 SHA-256 哈希
+- 升级时只替换未被用户修改的框架文件
+- 用户自定义的 Skills/Rules/Workflows 不会被覆盖
+- 被用户修改过的框架文件生成 `.new` 冲突文件，由用户决策

package/skeleton/.agents/skills/pm-framework-evolve/references/directory-map.md CHANGED Viewed

@@ -14,73 +14,75 @@
 ### `rules/` — 规则注入
-| 文件 | 分类 | 职责 |
-|------|------|------|
-| `project-identity.md` | 🦴 | 项目身份声明、框架地图、约束分层 |
-| `anti-hallucination.md` | 🦴 | 反幻觉约束、检索优先级 |
-| `coding-standards.md` | 🦴 | 编码规范 |
-| `framework-dev-mode.md` | 🔧 | 框架开发模式（不同步到 skeleton） |
+| 文件                    | 分类 | 职责                              |
+| ----------------------- | ---- | --------------------------------- |
+| `project-identity.md`   | 🦴   | 项目身份声明、框架地图、约束分层  |
+| `anti-hallucination.md` | 🦴   | 反幻觉约束、检索优先级            |
+| `coding-standards.md`   | 🦴   | 编码规范                          |
+| `framework-dev-mode.md` | 🔧   | 框架开发模式（不同步到 skeleton） |
 ### `workflows/` — 角色入口
-| 文件 | 分类 | 职责 |
-|------|------|------|
-| `pm.md` | 🦴 | PM 角色入口（`/pm` 触发） |
-| `worker.md` | 🦴 | Worker 角色入口（`/worker` 触发） |
-| `publish.md` | 🔧 | 发布工作流（不同步到 skeleton） |
+| 文件         | 分类 | 职责                              |
+| ------------ | ---- | --------------------------------- |
+| `pm.md`      | 🦴   | PM 角色入口（`/pm` 触发）         |
+| `worker.md`  | 🦴   | Worker 角色入口（`/worker` 触发） |
+| `publish.md` | 🔧   | 发布工作流（不同步到 skeleton）   |
 ### `skills/` — 能力模块
-所有 Skill 目录均为 🦴 骨架文件：
+所有 Skill 目录均为 🦴 骨架文件（10 个）：
 ```text
 skills/
-├── common-session-close/    # 会话收尾
-├── common-spec-update/      # 规范更新
-├── pm-brainstorm/           # 需求发散
-├── pm-framework-evolve/     # 框架自迭代（含 references/ resources/ changelog/）
 ├── pm-session-start/        # 会话启动
+├── pm-brainstorm/           # 需求发散
 ├── pm-task-planning/        # 任务规划
 ├── pm-task-review/          # 任务验收
+├── pm-framework-evolve/     # 框架自迭代（含 references/ resources/ changelog/）
+├── worker-implement/        # 执行者实现
 ├── worker-check/            # 执行者自检
 ├── worker-debug/            # 系统性调试
-└── worker-implement/        # 执行者实现
+├── common-session-close/    # 会话收尾
+└── common-spec-update/      # 规范更新
 ```
 ---
 ## `.trellis/` — 数据持久层
-| 路径 | 分类 | 职责 |
-|------|------|------|
-| `config/config.yaml` | 🦴 | 框架配置 |
-| `spec/` | 🦴 + 🏃 | 项目规范（骨架 + 运行时扩展） |
-| `tasks/` | 🏃 | 任务文件（AI 动态创建） |
-| `tasks/archive/` | 🏃 | 已归档任务 |
-| `workspace/journal.md` | 🏃 | 会话日志 |
+| 路径                       | 分类    | 职责                              |
+| -------------------------- | ------- | --------------------------------- |
+| `config/config.yaml`       | 🦴      | 框架配置                          |
+| `config/context-budget.md` | 🦴      | 上下文预算配置                    |
+| `spec/`                    | 🦴 + 🏃 | 项目规范（骨架预设 + 运行时扩展） |
+| `spec/spec-schema.json`    | 🦴      | 规范文件 JSON Schema              |
+| `tasks/`                   | 🏃      | 任务文件（AI 动态创建）           |
+| `tasks/archive/`           | 🏃      | 已归档任务                        |
+| `workspace/journal.md`     | 🏃      | 会话日志                          |
 ---
 ## `.docs/` — 用户文档空间
-| 路径 | 分类 | 职责 |
-|------|------|------|
-| `README.md` | 🦴 | 文档空间说明 |
-| `requirements/` | 🦴 + 🏃 | 需求文档 |
-| `design/` | 🦴 + 🏃 | 设计文档 |
-| `guides/` | 🦴 + 🏃 | 使用指南 |
-| `notes/` | 🦴 + 🏃 | 临时文档 |
-| `archive/` | 🦴 + 🏃 | 归档 |
+| 路径            | 分类    | 信息方向  | 职责         |
+| --------------- | ------- | --------- | ------------ |
+| `README.md`     | 🦴      | —         | 文档空间说明 |
+| `requirements/` | 🦴 + 🏃 | 用户 → AI | 需求文档     |
+| `design/`       | 🦴 + 🏃 | AI ↔ 用户 | 设计文档     |
+| `guides/`       | 🦴 + 🏃 | AI → 用户 | 使用指南     |
+| `notes/`        | 🦴 + 🏃 | 用户 ↔ AI | 临时文档     |
+| `archive/`      | 🦴 + 🏃 | —         | 文档归档     |
 ---
-## `packages/mcp-server/` — 可编程层
+## MCP Server — 可编程层
-| 路径 | 分类 | 职责 |
-|------|------|------|
-| `src/index.ts` | 🔧 | MCP Server 入口（TypeScript 源码） |
-| `src/tools/` | 🔧 | 14+ 个 MCP Tool 实现 |
-| `src/resources/` | 🔧 | 5 个 MCP Resource 实现 |
-| `src/utils/` | 🔧 | 工具函数 |
+> 源码位于 `packages/mcp-server/`（🔧 开发专属）。用户通过 npm 包 `@geeseeker/easyai-dev` 获得编译后的 JavaScript 版本。
-> 用户项目中通过 `easyAI-dev-latest/lib/server/` 获得编译后的 JavaScript 版本。
+| 路径             | 内容                                                |
+| ---------------- | --------------------------------------------------- |
+| `src/index.ts`   | MCP Server 入口                                     |
+| `src/tools/`     | 16 个文件，注册 21 个 Tools                         |
+| `src/resources/` | 5 个文件，注册 6 个 Resources                       |
+| `src/utils/`     | 工具函数（task-utils, git-utils, journal-utils 等） |

package/skeleton/.agents/skills/pm-framework-evolve/references/features.md CHANGED Viewed

@@ -2,75 +2,116 @@
 > 本文档是框架知识库的一部分，供 AI 在框架自迭代时参考。
-## Skills（能力模块）
+## Skills（10 个能力模块）
-### PM 专属
+### PM 专属（5 个）
-| Skill | 触发条件 | 职责 |
-|-------|----------|------|
-| `pm-brainstorm` | PM 接收到用户新需求时 | 苏格拉底式需求发散，将用户想法转化为完整设计 |
-| `pm-session-start` | `/pm` 触发后 | 自动读取项目状态、恢复任务上下文、加载最新日志 |
-| `pm-task-planning` | PM 完成需求澄清后 | 将设计文档转化为约束集格式的任务定义 |
-| `pm-task-review` | PM 审查执行者提交的任务时 | 三阶段验收（Spec 合规 → 代码质量 → Artifacts 沉淀） |
-| `pm-framework-evolve` | 需要修改框架文件或查询框架知识时 | 框架百科 + 安全迭代 + 迭代记录 + 知识库自更新 |
+| Skill                 | 触发条件                         | 职责                                                |
+| --------------------- | -------------------------------- | --------------------------------------------------- |
+| `pm-session-start`    | `/pm` 触发后                     | 自动读取项目状态、恢复任务上下文、加载最新日志      |
+| `pm-brainstorm`       | PM 接收到用户新需求时            | 苏格拉底式需求发散，将用户想法转化为完整设计        |
+| `pm-task-planning`    | PM 完成需求澄清后                | 将设计文档转化为约束集格式的任务定义                |
+| `pm-task-review`      | PM 审查执行者提交的任务时        | 三阶段验收（Spec 合规 → 代码质量 → Artifacts 沉淀） |
+| `pm-framework-evolve` | 需要修改框架文件或查询框架知识时 | 框架百科 + 安全迭代 + 知识库自更新                  |
-### Worker 专属
+### Worker 专属（3 个）
-| Skill | 触发条件 | 职责 |
-|-------|----------|------|
-| `worker-implement` | Worker 开始实现任务时 | TDD 铁律驱动的编码流程 |
-| `worker-check` | `worker-implement` 完成后 | 强制验证流程，生成 verification.md |
-| `worker-debug` | 遇到 Bug、测试失败时 | 4 阶段根因分析 + 3 次失败上报 PM |
+| Skill              | 触发条件                  | 职责                               |
+| ------------------ | ------------------------- | ---------------------------------- |
+| `worker-implement` | Worker 开始实现任务时     | TDD 铁律驱动的编码流程             |
+| `worker-check`     | `worker-implement` 完成后 | 强制验证流程，生成 verification.md |
+| `worker-debug`     | 遇到 Bug、测试失败时      | 4 阶段根因分析 + 3 次失败上报 PM   |
-### 通用
+### 通用（2 个）
-| Skill | 触发条件 | 职责 |
-|-------|----------|------|
-| `common-session-close` | 会话结束前 | 汇总工作、写入 journal、Artifacts 沉淀检查 |
-| `common-spec-update` | 需要更新 `.trellis/spec/` 时 | 安全地更新项目规范文件 |
+| Skill                  | 触发条件                                      | 职责                                       |
+| ---------------------- | --------------------------------------------- | ------------------------------------------ |
+| `common-session-close` | 用户说「收工」/ 会话结束 / 上下文预算接近阈值 | 汇总工作、写入 journal、Artifacts 沉淀检查 |
+| `common-spec-update`   | 需要更新 `.trellis/spec/` 时                  | 安全地更新项目规范文件                     |
 ---
-## Rules（规则）
+## Rules（3 个骨架 + 1 个开发专属）
-| Rule | 作用 | 约束层级 |
-|------|------|----------|
-| `project-identity.md` | 项目身份声明 — 框架地图、角色系统、约束分层、冲突解决 | L1（硬约束） |
-| `anti-hallucination.md` | 反幻觉约束 — 第三方库必须先查文档、禁止模糊措辞、RPI 阶段隔离 | L1（硬约束） |
-| `coding-standards.md` | 编码规范 — 命名、格式、注释标准 | L1（硬约束） |
-| `framework-dev-mode.md` | 框架开发模式 — 仅存在于开发工作区，不同步到 skeleton | L1（硬约束） |
+| Rule                    | 作用                                                          | 分类        |
+| ----------------------- | ------------------------------------------------------------- | ----------- |
+| `project-identity.md`   | 项目身份声明 — 框架地图、角色系统、约束分层、冲突解决         | 🦴 骨架     |
+| `anti-hallucination.md` | 反幻觉约束 — 第三方库必须先查文档、禁止模糊措辞、RPI 阶段隔离 | 🦴 骨架     |
+| `coding-standards.md`   | 编码规范 — 命名、格式、注释标准                               | 🦴 骨架     |
+| `framework-dev-mode.md` | 框架开发模式 — 三层版本流转、PM 使用本 Skill 的方式           | 🔧 开发专属 |
 ---
-## MCP Tools
-| Tool | 功能 |
-|------|------|
-| `task_create` | 创建新任务 |
-| `task_get` | 获取任务详情 |
-| `task_list` | 列出所有任务 |
-| `task_transition` | 任务状态流转 |
-| `task_cancel` | 取消任务 |
-| `task_append_log` | 追加任务执行记录 |
-| `subtask_create` / `subtask_list` | 子任务管理 |
-| `journal_append` | 写入 journal 日志 |
-| `journal_search` | 搜索 journal 记录 |
-| `plan_validate` | 反面模式自检 |
-| `spec_validate` | 规范文件校验 |
-| `conflict_check` | Glob 冲突检测 |
-| `context_budget` | 上下文预算查询 |
-| `context_generate` | 上下文生成 |
-| `framework_init` / `framework_check` / `framework_update` | 框架管理（在 `framework-tools.ts` 中） |
-## MCP Resources
-| Resource URI | 功能 |
-|-------------|------|
-| `trellis://journal/latest` | 最新 journal 日志 |
-| `trellis://status/overview` | 项目状态概览 |
-| `spec://{category}/{name}` | 项目规范文件 |
-| `trellis://tasks/{task_id}/context` | 任务上下文 |
-| `trellis://subtasks/{task_id}/context` | 子任务上下文 |
+## MCP Tools（21 个）
+### 任务管理（6 个）
+| Tool              | 功能                                  |
+| ----------------- | ------------------------------------- |
+| `task_create`     | 创建新任务                            |
+| `task_get`        | 获取任务详情（含冻结上下文快照）      |
+| `task_list`       | 列出所有任务（支持状态过滤）          |
+| `task_transition` | 任务状态流转（含 Evidence Gate 校验） |
+| `task_cancel`     | 取消任务                              |
+| `task_append_log` | 追加任务执行记录                      |
+### 子任务（2 个）
+| Tool                       | 功能                                       |
+| -------------------------- | ------------------------------------------ |
+| `subtask_create`           | 创建子任务（支持 DAG 依赖声明 + 循环检测） |
+| `subtask_dependency_graph` | 获取子任务依赖图                           |
+### 日志（2 个）
+| Tool             | 功能                                      |
+| ---------------- | ----------------------------------------- |
+| `journal_append` | 写入 journal 日志                         |
+| `journal_search` | 搜索 journal 记录（按标签、关键词、日期） |
+### 上下文管理（2 个）
+| Tool               | 功能                                                      |
+| ------------------ | --------------------------------------------------------- |
+| `context_budget`   | 估算当前 Token 消耗（超 60% 建议降级，超 80% 建议新会话） |
+| `context_generate` | 生成 context.jsonl 推荐清单                               |
+### 质量保障（3 个）
+| Tool             | 功能                                        |
+| ---------------- | ------------------------------------------- |
+| `plan_validate`  | 反面模式自检（多方案未选择、推迟决策等）    |
+| `spec_validate`  | 规范文件格式校验（必须字段、SemVer 版本号） |
+| `conflict_check` | 文件范围冲突检测（Glob 模式匹配）           |
+### 框架管理（3 个）
+| Tool               | 功能                      |
+| ------------------ | ------------------------- |
+| `framework_init`   | 初始化框架到项目          |
+| `framework_check`  | 检查框架完整性            |
+| `framework_update` | Manifest 驱动智能合并升级 |
+### Git Worktree（3 个）
+| Tool               | 功能                                        |
+| ------------------ | ------------------------------------------- |
+| `worktree_create`  | 为任务创建 Git worktree（并行任务物理隔离） |
+| `worktree_merge`   | 将 worktree 分支合并回目标分支              |
+| `worktree_cleanup` | 清理 worktree 及其分支                      |
+---
+## MCP Resources（6 个）
+| Resource URI                           | 功能                              |
+| -------------------------------------- | --------------------------------- |
+| `trellis://status`                     | 项目状态概览（Git + 任务 + 日志） |
+| `trellis://journal/latest`             | 最新 journal 日志                 |
+| `spec://{category}/{name}`             | 项目规范文件                      |
+| `trellis://tasks/{task_id}/context`    | 任务上下文（含冻结快照）          |
+| `trellis://subtasks/{task_id}/context` | 子任务依赖上下文                  |
+| `trellis://tasks/{task_id}/frozen`     | 冻结的 spec 快照（Phase-Frozen）  |
 ---
@@ -78,8 +119,8 @@
 ```mermaid
 graph TD
-    PM[PM 角色] --> BS[pm-brainstorm]
-    PM --> SS[pm-session-start]
+    PM[PM 角色] --> SS[pm-session-start]
+    PM --> BS[pm-brainstorm]
     PM --> TP[pm-task-planning]
     PM --> TR[pm-task-review]
     PM --> FE[pm-framework-evolve]
@@ -92,7 +133,8 @@ graph TD
     TP -->|创建任务| WI
     WI -->|验证完成| WC
     WC -->|提交验收| TR
+    TR -->|Artifacts 沉淀| SC[common-session-close]
-    SC[common-session-close] --- PM
+    SC --- PM
     SC --- W
 ```

package/skeleton/.agents/skills/pm-framework-evolve/references/github-info.md CHANGED Viewed

@@ -11,17 +11,16 @@
 ## 查看迭代历史
-1. **Git log**：`git log --oneline -20`
+1. **CHANGELOG.md**：发布目录中的版本更新记录
 2. **GitHub Releases**：仓库 Releases 页面
-3. **框架内部 changelog**：`.agents/skills/pm-framework-evolve/changelog/`
+3. **Git log**：`git log --oneline -20`
-## 提交修改建议
+## 贡献方式
 1. **Issue**：在 GitHub 仓库提交 Issue 描述问题或建议
 2. **Pull Request**：Fork 后提交 PR
-3. **框架内部迭代**：通过 `pm-framework-evolve` Skill 进行安全迭代
 ## 开发者信息
 - **作者**：GeeSeeker
-- **许可证**：参见仓库 LICENSE 文件
+- **许可证**：MIT

package/skeleton/.agents/skills/pm-framework-evolve/references/installation.md CHANGED Viewed

@@ -4,29 +4,36 @@
 ## 安装方式
-### 方式 1：npx 脚手架（推荐）
+### 方式 1：让 AI 帮你安装（推荐）
+复制以下文字到 Antigravity 对话框：
+```
+请帮我安装 easyAI 框架。
+安装指南：https://raw.githubusercontent.com/GeeSeeker/easyAI-dev/main/README_AI.md
+请读取这份指南，按步骤自动完成配置。
+```
+### 方式 2：命令行安装
 ```bash
 # 新项目
-npx @geeseeker/easyai-dev init
+npx @geeseeker/easyai-dev init my-project
 # 已有项目（不覆盖 README.md，合并 .gitignore）
-npx @geeseeker/easyai-dev init
+cd your-project
+npx @geeseeker/easyai-dev init .
 ```
-### 方式 2：MCP 全局安装
-配置 AI IDE 的 MCP Server 后，AI 可通过 `framework_init` tool 自动安装：
+然后在 Antigravity IDE 的 MCP 设置中添加：
 ```json
 {
-  "mcpServers": {
-    "easyai-dev": {
-      "command": "npx",
-      "args": ["-y", "@geeseeker/easyai-dev", "serve"],
-      "env": {
-        "EASYAI_PROJECT_ROOT": "/path/to/project"
-      }
+  "easyai-mcp-server": {
+    "command": "npx",
+    "args": ["-y", "@geeseeker/easyai-dev", "serve"],
+    "env": {
+      "EASYAI_PROJECT_ROOT": "/path/to/your/project"
     }
   }
 }
@@ -41,12 +48,13 @@ project/
 │   ├── workflows/     # PM + Worker 入口
 │   └── skills/        # 10 个能力模块
 ├── .trellis/          # 数据持久层
-│   ├── config/        # config.yaml
+│   ├── config/        # config.yaml + context-budget.md
 │   ├── spec/          # 项目规范
 │   ├── tasks/         # 任务目录
 │   └── workspace/     # journal
 ├── .docs/             # 用户文档空间（5 个子文件夹）
-└── .easyai-version    # 版本标记文件
+├── .easyai-version    # 版本标记文件
+└── .easyai-manifest.json  # 框架文件清单（用于智能升级）
 ```
 ## 版本管理
@@ -54,7 +62,8 @@ project/
 - **版本标记**：`.easyai-version` 文件记录当前安装版本
 - **检查更新**：`npx @geeseeker/easyai-dev check` 或 MCP `framework_check` tool
 - **执行更新**：`npx @geeseeker/easyai-dev update` 或 MCP `framework_update` tool
-- **备份机制**：更新前自动备份被修改的文件
+- **智能合并**：Manifest 驱动 — 只更新框架文件，保护用户自定义内容（自定义 Skills/Rules/Workflows 不被覆盖）
+- **冲突处理**：用户修改过的框架文件生成 `.new` 冲突文件，由用户手动合并
 ## npm 包信息

package/skeleton/easyai-manifest.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
-  "version": "3.0.7",
-  "generatedAt": "2026-03-12T13:24:32.935Z",
+  "version": "3.0.8",
+  "generatedAt": "2026-03-12T14:27:05.309Z",
   "files": {
     ".agents/rules/anti-hallucination.md": {
       "hash": "0d18aafe1cdacf5db0e71eb06c559ab01df9deebb99804ad514930cc7d59c749"
@@ -12,7 +12,7 @@
       "hash": "42f56e40168cd2528b72a7d99e862be806e1af0a89e609b51fdad42cb8c06758"
     },
     ".agents/skills/common-session-close/SKILL.md": {
-      "hash": "491132b12d8a1e327afdb16d9667031ad703abd9d184d8b26b3d160318d58517"
+      "hash": "81703e51dc2fed75145a808018351c7799ad0a8f347524366055f633182c1977"
     },
     ".agents/skills/common-spec-update/SKILL.md": {
       "hash": "cca0e3176a235d5a2b33f419e80b4e35409e377b915de14a8cd35283eb980630"
@@ -21,25 +21,25 @@
       "hash": "56091ee907d737a6d9301198909b3ad6d4b6c51b77c1836226e247bef68516f5"
     },
     ".agents/skills/pm-framework-evolve/SKILL.md": {
-      "hash": "9e5564d7a5de0902f802acd3ccb30e2bdbf152d38539cd7f7d0e391424b1ce4f"
+      "hash": "4c8253069ba2b7303060b8c2adc28487ed7c433b54ed48e55a4c90cfa65c52c6"
     },
     ".agents/skills/pm-framework-evolve/changelog/index.md": {
       "hash": "3f307c523ed8d80845cf575e4d1f53958d34d326bf548eef8a720c190f35c85d"
     },
     ".agents/skills/pm-framework-evolve/references/architecture.md": {
-      "hash": "a6963837139ebeebc791d10736110683233ac6a6ef4465ad30ac8d2ca4bf4670"
+      "hash": "d70dbc52236cf36a57b5837663d5b9e3833c6a15405c7b1e378d24a67a28f755"
     },
     ".agents/skills/pm-framework-evolve/references/directory-map.md": {
-      "hash": "941e49ac6de554ff1c3d0c0e33d1dc576a8b9720506acc1263df6c787434f0cc"
+      "hash": "e774508317279821ef20cf6e4116ba9f3bfc07123db94337e609f07b95732d31"
     },
     ".agents/skills/pm-framework-evolve/references/features.md": {
-      "hash": "7a0b6a9c5e789efffd3479ed679c950e2ffda57878995fa04c5606c8dac30dd2"
+      "hash": "c965cd4a08c9c05f30f2cb294c879ce75481cb7a8183cd1f13b45938a1d1a798"
     },
     ".agents/skills/pm-framework-evolve/references/github-info.md": {
-      "hash": "762304a2279fb07dde46e8d0e63ae0fe534064274088ae70b95327577d881994"
+      "hash": "b2e367ecbaa2c7064ad448bbadb1ed0dc0d70a5be0409205974cba6518e585ba"
     },
     ".agents/skills/pm-framework-evolve/references/installation.md": {
-      "hash": "c2e66dc8710988f54e08b2b518bf5e83b7eb82107a525af6e57e56d17e101181"
+      "hash": "c5d52b2ee2ba7167dd4be5cc7ed8ca61e4a32249e4568fa779f2f139c78ca8f1"
     },
     ".agents/skills/pm-framework-evolve/resources/changelog-entry-template.md": {
       "hash": "801ae16c13edcf6f6efefeecb91e74ebf269e73841d2c8db4e4e5de81143fe7c"