ys-team 0.2.0 → 0.3.0

package/docs/specs/{active → completed}/20260407-170500-npm-distribution-modes/control.md

@@ -1,7 +1,7 @@
 ---
 Spec-Type: control
 Initiative: 20260407-170500-npm-distribution-modes
-Status: active
+Status: completed
 Owner-Session: ys-team
 Write-Scope: []
 Depends-On: []

package/docs/specs/{active → completed}/20260407-170500-npm-distribution-modes/evidence/20260407-dual-mode-and-publish-readiness.md

@@ -37,22 +37,20 @@
 - 结果：PASS
 - 说明：当前环境可识别 npm 用户 `ys7399`
 
-### `npm view ys-team version name`
+### `npm view ys-team version name dist-tags.latest`
 
 - 结果：PASS
-- 说明：返回 404，说明 `ys-team` 包名当前未被占用
+- 说明：registry 已返回 `ys-team@0.2.0`，`latest` 已指向 `0.2.0`
 
 ### `npm publish`
 
-- 结果：BLOCKED
-- 说明：registry 返回 `E403`，当前凭证不满足 publish 要求，需要 OTP 或带 `bypass 2fa` 的 granular access token
+- 结果：PASS
+- 说明：已成功发布 `ys-team@0.2.0`
 
 ## Current Conclusion
 
-代码形态已经 ready to publish。
-
-真实发布仍阻塞于：
+双模式安装和 npm 发布链路都已完成闭环。
 
-- publish 级别凭证
-- 可能的 OTP
-- 或重新生成带 `bypass 2fa` 的 granular access token
+- 全局模式：`npx ys-team install-skills`
+- 项目模式：`npx ys-team init-project --dir /path/to/project`
+- npm registry：`ys-team@0.2.0`

package/examples/baseline/.ys_team/VERSION

@@ -1 +1 @@
-0.2.0
+0.3.0

package/examples/baseline/.ys_team/memory/policy.md

@@ -0,0 +1,66 @@
+# 记忆管理策略
+
+## 结构
+
+```
+.ys_team/memory/
+  ├── roles/           ← 角色独立记忆（跨任务经验）
+  │   └── <role>.md    ← 每个角色一个文件
+  └── policy.md        ← 本文件
+```
+
+工作记忆（workspace.md）不在此目录，而是跟随 spec 生命周期，位于 `docs/specs/<id>/workspace.md`。
+
+## 角色独立记忆
+
+- 每个角色只读写自己的记忆文件，互不可见
+- 记录跨任务的经验积累，不记录当前任务的临时状态
+- 长度上限由 TEAM.md 的 `memory.role_memory_limit` 配置（默认 2k）
+
+### 写入时机
+
+每个阶段结束时，角色回顾本次工作，决定是否有值得记住的经验。使用以下判断标准：
+
+1. 是否发现了非显而易见的技术陷阱或模式？
+2. 是否有需要在未来同类任务中注意的点？
+3. 是否有关于这个项目/模块的特殊知识？
+
+无新认知时不写入。
+
+### 压缩策略
+
+读取记忆时发现超限，结合本次要写入的新内容一起压缩：
+
+- 保留所有仍然相关的经验
+- 合并相似条目
+- 删除已过时或被后续经验覆盖的条目
+- 保留具体的文件路径、错误信息、配置值，不泛化
+- 压缩后不超过配置上限
+
+### 记忆格式
+
+```markdown
+# <role> 经验记忆
+
+## <主题 1>
+- 具体经验条目（含日期标记）
+
+## <主题 2>
+- 具体经验条目（含日期标记）
+```
+
+按主题分组，每条经验附日期，便于判断时效性。
+
+## 工作记忆（workspace.md）
+
+- 位于 `docs/specs/<id>/workspace.md`
+- 记录当前任务的实时状态：进度、阻塞、决策、各阶段间传递的上下文
+- 长度上限由 TEAM.md 的 `memory.workspace_limit` 配置（默认 2k）
+- spec 关闭后自动归档（随 spec 目录保留）
+
+## 健康检查
+
+rebuild 时检查：
+- 角色记忆文件是否超限
+- 是否有角色记忆文件对应的角色已从 TEAM.md 移除（标记为归档，不删除）
+- 是否有新角色缺少记忆文件（自动创建空文件）

package/examples/baseline/.ys_team/memory/roles/delivery-guard.md

@@ -0,0 +1,3 @@
+# delivery-guard 经验记忆
+
+（暂无记录）

package/examples/baseline/.ys_team/memory/roles/doc-spec-steward.md

@@ -0,0 +1,3 @@
+# doc-spec-steward 经验记忆
+
+（暂无记录）

package/examples/baseline/.ys_team/memory/roles/domain-integrator.md

@@ -0,0 +1,3 @@
+# domain-integrator 经验记忆
+
+（暂无记录）

package/examples/baseline/.ys_team/memory/roles/project-architect.md

@@ -0,0 +1,3 @@
+# project-architect 经验记忆
+
+（暂无记录）

package/examples/baseline/.ys_team/memory/roles/qa-guard.md

@@ -0,0 +1,3 @@
+# qa-guard 经验记忆
+
+（暂无记录）

package/examples/baseline/.ys_team/memory/roles/spec-reviewer.md

@@ -0,0 +1,3 @@
+# spec-reviewer 经验记忆
+
+（暂无记录）

package/examples/baseline/.ys_team/roles/internal/qa-guard.md

@@ -0,0 +1,30 @@
+# qa-guard
+Title: 质量保障守门人
+subagent_policy: local_only
+
+独立验证落地效果是否符合 spec。读取 spec、代码变更和测试结果，不参与执行过程，确保验证客观性。
+
+## 职责
+
+- 对比 control.md 的 verification 条目与实际落地结果
+- 执行或检查测试命令，验证功能正确性
+- 检查 write-scope 内的代码变更是否符合 spec 要求
+- 识别遗漏的验收点、未覆盖的边界条件
+- 输出 qa-report.md（result card 格式：PASS / REJECT + issues）
+
+## 输入
+
+- `docs/specs/<id>/control.md`（spec 定义）
+- `docs/specs/<id>/work.md`（执行记录）
+- `docs/specs/<id>/workspace.md`（工作记忆）
+- 项目代码（write-scope 范围内）
+
+## 输出
+
+- `docs/specs/<id>/qa-report.md`
+
+## 约束
+
+- 只读 + 可执行测试命令，不修改业务代码
+- 不参与执行过程的讨论或决策
+- 验证意见必须具体到哪个 verification 条目、实际结果是什么、差异在哪

package/examples/baseline/.ys_team/roles/internal/spec-reviewer.md

@@ -0,0 +1,28 @@
+# spec-reviewer
+Title: 规格审阅人
+subagent_policy: local_only
+
+独立审阅 spec 是否完整覆盖原始需求。只接触需求文件和 spec 文件，不接触讨论历史，确保审阅客观性。
+
+## 职责
+
+- 对比 requirement.md 和 control.md，检查需求覆盖完整性
+- 检查 spec 的 write-scope 是否合理、verification 是否可执行
+- 识别遗漏的边界条件、异常路径、依赖关系
+- 输出 review.md（result card 格式：PASS / REJECT + issues）
+
+## 输入
+
+- `docs/specs/<id>/requirement.md`（原始需求）
+- `docs/specs/<id>/control.md`（spec 定义）
+- 项目现实索引（`docs/project/module-index.md`，如存在）
+
+## 输出
+
+- `docs/specs/<id>/review.md`
+
+## 约束
+
+- 只读权限，不修改任何文件（review.md 除外）
+- 不接触讨论历史或 workspace.md
+- 审阅意见必须具体到 spec 的哪个部分、缺什么、为什么

package/examples/baseline/.ys_team/status.md

@@ -4,9 +4,28 @@ updated: —
 
 ## 活跃 Spec
 
-| Spec | 阶段 | 负责角色 | 状态 |
-|------|------|---------|------|
-| — | — | — | — |
+| Spec | 阶段 | 状态 | 负责角色 | 重试次数 | 模式 |
+|------|------|------|---------|---------|------|
+| — | — | — | — | — | — |
+
+### 状态值
+
+- `idle` — 未开始
+- `spec-talk` — 讨论中
+- `spec-review` — 审阅中
+- `spec-work` — 执行中
+- `qa` — 验证中
+- `close` — 关闭中
+- `done` — 已完成
+- `halt` — 已暂停（重试耗尽，等用户决策）
+
+### 状态流转
+
+```
+idle → spec-talk → spec-review → spec-work → qa → close → done
+                 ↑  [REJECT] ←┘            ↑  [REJECT] ←┘
+                 ↑  [EXHAUST] → halt       ↑  [EXHAUST] → halt
+```
 
 ## 最新判断
 

package/examples/baseline/.ys_team/team.md

@@ -8,6 +8,10 @@
   - tools: []
 - `doc-spec-steward`
   - tools: []
+- `spec-reviewer`
+  - tools: []
+- `qa-guard`
+  - tools: []
 - `delivery-guard`
   - tools: []
 
@@ -16,6 +20,8 @@
 - 涉及系统边界、模块职责和主链路设计时，必须包含 `project-architect`。
 - 涉及外部系统、契约、集成面或领域适配时，必须包含 `domain-integrator`。
 - 涉及项目文档、spec、模板或对外说明时，必须包含 `doc-spec-steward`。
+- spec 落地前的独立审阅，必须包含 `spec-reviewer`。
+- 落地效果验证，必须包含 `qa-guard`。
 - 涉及验收、风险、回滚和证据时，必须包含 `delivery-guard`。
 
 ## Tools Binding

package/examples/baseline/TEAM.md

@@ -0,0 +1,43 @@
+# Team Configuration
+
+## mode
+
+default: manual
+# manual:    用户手动推进每个阶段（现有模式）
+# semi-auto: 自动流转，执行前和关闭前暂停等确认
+# full-auto: 全自动，只在重试耗尽时暂停
+
+## limits
+
+spec_review_max_retries: 3
+qa_max_retries: 3
+auto_downgrade_on_exhaust: true
+
+## memory
+
+role_memory_limit: 2k
+workspace_limit: 2k
+
+## roles
+
+# 从方法论角色库中选用，init 时根据项目类型推荐默认组合
+# 用户可自由增删改，角色定义在 .ys_team/roles/ 中
+
+- project-architect:   tools: [Read, Write, Edit, Bash, Glob, Grep]
+- domain-integrator:   tools: [Read, Write, Edit, Bash, Glob, Grep]
+- doc-spec-steward:    tools: [Read, Write, Edit, Glob, Grep]
+- spec-reviewer:       tools: [Read, Glob, Grep]
+- qa-guard:            tools: [Read, Glob, Grep, Bash]
+- delivery-guard:      tools: [Read, Glob, Grep]
+
+## spec_dir
+
+docs/specs/
+
+## state_machine
+
+# Spec 生命周期状态流转（持久化在 status.md 每个 spec 条目中）
+# idle → spec-talk → spec-review → spec-work → qa → close → done
+# spec-review REJECT → spec-talk（重试）
+# qa REJECT → spec-work（重试）
+# 重试耗尽 → halt（降级半自动，等用户决策）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ys-team",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "AI 团队治理方法论：以共享现实索引为对齐基础、以 Spec 为执行与验收统一依据的轻量治理框架",
   "keywords": [
     "claude-code",

package/scripts/ys-team.mjs

@@ -3,6 +3,7 @@
 import fs from "node:fs";
 import path from "node:path";
 import os from "node:os";
+import https from "node:https";
 import { fileURLToPath } from "node:url";
 
 const __filename = fileURLToPath(import.meta.url);
@@ -26,6 +27,7 @@ function helpText() {
     "- ys-team --help",
     "- ys-team install-skills [--dest <dir>] [--force] [--dry-run]",
     "- ys-team init-project [--dir <project-dir>] [--force] [--dry-run]",
+    "- ys-team check-update",
     "",
     "Default global install destination:",
     `- ${defaultSkillsDir()}`,
@@ -253,6 +255,61 @@ function initProject({ dir, force, dryRun }) {
   ].join("\n");
 }
 
+function fetchLatestVersion(packageName) {
+  return new Promise((resolve, reject) => {
+    const url = `https://registry.npmjs.org/${packageName}/latest`;
+    https.get(url, { headers: { Accept: "application/json" } }, (res) => {
+      let data = "";
+      res.on("data", (chunk) => { data += chunk; });
+      res.on("end", () => {
+        try {
+          const json = JSON.parse(data);
+          resolve(json.version);
+        } catch {
+          reject(new Error("解析 npm registry 响应失败"));
+        }
+      });
+    }).on("error", reject);
+  });
+}
+
+function compareVersions(a, b) {
+  const pa = a.split(".").map(Number);
+  const pb = b.split(".").map(Number);
+  for (let i = 0; i < 3; i++) {
+    if ((pa[i] ?? 0) > (pb[i] ?? 0)) return 1;
+    if ((pa[i] ?? 0) < (pb[i] ?? 0)) return -1;
+  }
+  return 0;
+}
+
+async function checkUpdate() {
+  const localPkg = JSON.parse(fs.readFileSync(path.join(packageRoot, "package.json"), "utf8"));
+  const localVersion = localPkg.version;
+
+  process.stdout.write("正在检查更新...\n");
+  const latestVersion = await fetchLatestVersion(localPkg.name);
+  const cmp = compareVersions(latestVersion, localVersion);
+
+  const lines = [
+    "ys-team check-update",
+    "",
+    `已安装版本: v${localVersion}`,
+    `npm 最新版:  v${latestVersion}`,
+  ];
+
+  if (cmp === 0) {
+    lines.push("", "已是最新版本。");
+  } else if (cmp > 0) {
+    lines.push("", "发现新版本，运行以下命令更新 skills：");
+    lines.push(`  npx ys-team@${latestVersion} install-skills --force`);
+  } else {
+    lines.push("", "本地版本比 npm 更新（开发中或未发布）。");
+  }
+
+  return lines.join("\n");
+}
+
 function main() {
   try {
     const args = parseArgs(process.argv);
@@ -272,6 +329,17 @@ function main() {
       process.exit(0);
     }
 
+    if (args.command === "check-update") {
+      checkUpdate().then((output) => {
+        console.log(output);
+        process.exit(0);
+      }).catch((err) => {
+        console.error(`ys-team error: ${err.message}`);
+        process.exit(1);
+      });
+      return;
+    }
+
     console.error(`Unsupported command: ${args.command}`);
     console.error("Run `ys-team --help`.");
     process.exit(1);

package/skills/ys-team/SKILL.md

@@ -64,6 +64,69 @@ Its job is to keep the conversation anchored in:
   - 用户明确声明是 trivial（如"修拼写错误"、"改注释"）
 - **原则**：举证责任在"跳过路由"，而不在"触发路由"。不确定时，触发。
 
+## TEAM.md 加载
+
+当仓库存在 `TEAM.md` 时，ys-team 入口 skill 必须在路由判断前加载它。
+
+`TEAM.md` 是 ys-team 工作流的唯一用户配置面板，包含：
+- `mode`：工作模式（manual / semi-auto / full-auto）
+- `limits`：重试上限、降级策略
+- `memory`：记忆配额
+- `roles`：本项目启用的角色及工具权限
+- `spec_dir`：spec 目录路径
+
+如果 `TEAM.md` 不存在，使用默认值（mode: manual，其余同 baseline）。
+
+## 编排模式
+
+根据 `TEAM.md` 的 `mode` 配置，ys-team 入口 skill 有三种行为模式：
+
+### manual（默认）
+
+现有行为完全不变。用户手动推进每个阶段，ys-team 只做路由判断。
+新增的 spec-review 和 qa 阶段作为可用选项，用户可手动触发。
+
+### semi-auto
+
+用户提出需求后，主 session 进入编排循环，自动推进阶段流转：
+
+1. **spec-talk**：用 Agent tool 启动 subagent，多角色讨论，产出 spec 和 requirement.md
+2. **spec-review**：用 Agent tool 启动独立 subagent（prompt 只传文件路径，不传讨论历史）
+   - PASS → 继续
+   - REJECT → 回 spec-talk，将 review.md 作为输入，重试计数 +1
+   - 重试耗尽 → halt，输出当前状态，等用户决策
+3. **spec-work**：**暂停，提示用户确认后再启动** subagent 执行
+4. **qa**：用 Agent tool 启动独立 subagent，验证落地效果
+   - PASS → 继续
+   - REJECT → 回 spec-work，将 qa-report.md 作为输入，重试计数 +1
+   - 重试耗尽 → halt
+5. **close**：汇总报告输出，**暂停，等用户确认后执行** git commit + 更新 status.md 为 done
+
+### full-auto
+
+与 semi-auto 相同，但：
+- 阶段 3（spec-work）不暂停，直接启动
+- 阶段 5（close）不暂停，自动执行 git commit
+- 重试耗尽时仍然暂停（自动降级为半自动）
+
+### 编排规则
+
+- 每个阶段的 subagent 启动时，从 TEAM.md 读取该角色的工具权限，在 prompt 中声明
+- 每个阶段结束后，更新 status.md 中该 spec 的状态机字段
+- 阶段间通信通过 spec 目录下的文件（requirement.md、control.md、review.md、workspace.md、qa-report.md）
+- subagent prompt 只传文件路径，不传内容，确保上下文隔离
+- 每个 subagent 启动时读取自己的角色记忆（`.ys_team/memory/roles/<role>.md`），结束时回顾并写入新经验
+
+### 记忆集成
+
+所有模式下（包括 manual），角色在工作时都应：
+1. 启动时读取 `.ys_team/memory/roles/<role>.md`（如存在）
+2. 读取当前 spec 的 `workspace.md`（如存在）
+3. 结束时回顾本次工作，有新经验则写入角色记忆
+4. 更新 workspace.md 的工作状态
+
+记忆读写遵循 `.ys_team/memory/policy.md` 的规则。
+
 ## 排他工作流
 
 ys-team 启用后，工作流具有排他性：
@@ -105,8 +168,11 @@ ys-team 启用后，工作流具有排他性：
 
 **其他环节**也必须保留可见标志：
 
+- `spec-review`：`**[审阅]** ys-team · spec-review`
 - `spec-work`：`**[执行中]** ys-team · spec-work`
+- `qa`：`**[质检]** ys-team · qa`
 - `submit`：`**[验收]** ys-team · submit`
+- `close`：`**[关闭]** ys-team · close`
 - `status`：`**[状态]** ys-team · status`
 
 如果当前响应末尾没有任何 `ys-team` 标记，应视为尚未进入 ys-team 工作流，并立刻回到路由判断。

package/skills/ys-team-init/SKILL.md

@@ -43,11 +43,14 @@ Init 的第一步是确认用户主语言，所有角色名、角色卡、team.m
 
 Generate or adapt:
 
+- `TEAM.md`（从 `examples/baseline/TEAM.md` 适配，根据项目类型调整 roles 列表）
 - `.ys_team/README.md`
 - `.ys_team/team.md`
 - `.ys_team/methods.md`
 - `.ys_team/policy.md`
 - `.ys_team/templates/`
+- `.ys_team/memory/policy.md`（从 baseline 复制）
+- `.ys_team/memory/roles/`（根据 TEAM.md 的 roles 列表生成空记忆文件）
 - `docs/specs/`
 - `docs/roadmap/`
 
@@ -138,6 +141,24 @@ internalized: [日期]
 如需调整工具配置，可运行 /ys-team-rebuild。
 ```
 
+## TEAM.md 生成
+
+Init 时从 `examples/baseline/TEAM.md` 生成项目的 `TEAM.md`：
+
+1. 复制 baseline TEAM.md 到项目根目录
+2. 根据项目类型调整 roles 列表（如纯前端项目去掉 domain-integrator，加 frontend-accessibility-reviewer）
+3. 默认 mode 为 manual
+4. 提示用户可按需调整配置
+
+## 记忆系统初始化
+
+Init 时初始化记忆目录：
+
+1. 从 `examples/baseline/.ys_team/memory/policy.md` 复制记忆策略
+2. 创建 `.ys_team/memory/roles/` 目录
+3. 根据 TEAM.md 的 roles 列表，为每个角色创建空记忆文件（`<role>.md`）
+4. 提示用户记忆系统已就绪
+
 ## Status 初始化
 
 Init 时从 `examples/baseline/.ys_team/status.md` 复制空模板到项目的 `.ys_team/status.md`。

package/skills/ys-team-rebuild/SKILL.md

@@ -75,6 +75,26 @@ Rebuild 时除了更新基础配置，还需评估和更新工具内化：
 
 下次 rebuild 时会自动处理。
 
+## TEAM.md 同步
+
+Rebuild 时检查 TEAM.md 状态：
+
+1. 如果项目没有 `TEAM.md`（旧版本项目），从 baseline 生成一份，保留项目已有的角色配置
+2. 如果 baseline TEAM.md 有新增配置项（如新版本加了 memory 配置），合并到项目 TEAM.md 中，保留用户已有的自定义值
+3. 如果 TEAM.md 的 roles 列表与 `.ys_team/team.md` 不一致，以 TEAM.md 为准同步 team.md
+
+## 记忆健康检查
+
+Rebuild 时检查记忆系统状态：
+
+1. 如果 `.ys_team/memory/` 不存在（旧版本项目），从 baseline 初始化
+2. 检查角色记忆文件是否与 TEAM.md 的 roles 列表对齐：
+   - 新角色缺少记忆文件 → 创建空文件
+   - 角色已从 TEAM.md 移除但记忆文件存在 → 保留文件，在文件头部标记 `archived: true`
+3. 检查角色记忆文件是否超限（对比 TEAM.md 的 `memory.role_memory_limit`）：
+   - 超限的文件 → 提示用户，建议在下次角色工作时自动压缩
+4. 检查 `memory/policy.md` 是否需要更新（对比 baseline 版本）
+
 ## Doc-Build Integration
 
 After baseline update is complete, automatically invoke `ys-team-doc-build` to rebuild the reality index. This ensures `docs/project/module-index.md` reflects current project structure after any rebuild.

package/skills/ys-team-spec-talk/SKILL.md

@@ -9,12 +9,15 @@ Use this skill to discuss a non-trivial change using project-local team guidance
 
 ## Read Order
 
-1. `.ys_team/README.md`
-2. `.ys_team/team.md`
-3. `.ys_team/methods.md` if present
-4. `.ys_team/policy.md`
-5. repository project/docs context
-6. relevant active or queued specs or roadmaps if the task extends existing work
+1. `TEAM.md`（如存在，获取 mode、limits、memory 配置）
+2. `.ys_team/README.md`
+3. `.ys_team/team.md`
+4. `.ys_team/methods.md` if present
+5. `.ys_team/policy.md`
+6. 参与角色的记忆文件（`.ys_team/memory/roles/<role>.md`）
+7. 当前 spec 的 `workspace.md`（如存在，用于接续之前的讨论上下文）
+8. repository project/docs context
+9. relevant active or queued specs or roadmaps if the task extends existing work
 
 ## Loading Discipline
 
@@ -122,6 +125,38 @@ These sections should summarize:
 3. 如果用户同意，立即发起进化评估讨论（由现有角色参与，讨论是否引入新角色）
 4. 讨论收敛后：PASS → 创建角色卡并加入 team.md / REJECT → 记录原因关闭申请
 
+## Requirement 记录
+
+当讨论产出 spec 时，必须同时将原始需求写入 `docs/specs/<id>/requirement.md`：
+
+- 提取用户最初的需求描述（原文或精简版）
+- 记录需求来源（用户口述、Issue 链接等）
+- 此文件是 spec-review 阶段的核心输入之一
+
+## Workspace 写入
+
+讨论收敛后，将关键上下文写入 `docs/specs/<id>/workspace.md`：
+
+- 讨论中的关键决策和取舍
+- 各角色的核心观点摘要
+- 遗留问题或待确认事项
+- 长度不超过 TEAM.md 的 `memory.workspace_limit` 配置
+
+此文件是后续阶段（spec-review、spec-work）的共享工作记忆。
+
+## 角色记忆回顾
+
+讨论收敛后、写入 status.md 之前，每个参与角色回顾本次讨论：
+
+1. 读取自己的记忆文件（`.ys_team/memory/roles/<role>.md`）
+2. 判断本次讨论是否有值得记录的跨任务经验
+3. 如有，检查记忆是否超限：
+   - 未超限：直接追加新经验
+   - 已超限：结合新经验一起压缩后写回
+4. 如无新经验，不写入
+
+记忆读写遵循 `.ys_team/memory/policy.md` 的规则。
+
 ## Status 写入
 
 讨论收敛后（产出 result card 时），必须同步更新 `.ys_team/status.md`：

package/skills/ys-team-spec-work/SKILL.md

@@ -23,6 +23,35 @@ Use it to execute approved work against an existing repository spec.
 - keep implementation, docs, and evidence in sync
 - surface blockers instead of silently changing scope
 
+## Read Order
+
+1. `TEAM.md`（如存在，获取 mode、limits、memory 配置）
+2. 当前 spec 的 `control.md`（执行合约）
+3. 当前 spec 的 `workspace.md`（工作记忆，了解前序阶段的上下文）
+4. 当前 spec 的 `qa-report.md`（如存在，说明是 QA 打回后的重试，需针对性修复）
+5. 执行角色的记忆文件（`.ys_team/memory/roles/<role>.md`）
+6. `.ys_team/policy.md`
+
+## Workspace 更新
+
+执行过程中持续更新 `docs/specs/<id>/workspace.md`：
+
+- 执行开始时：记录执行计划和预期步骤
+- 遇到关键决策时：记录决策和原因
+- 遇到阻塞时：记录阻塞原因和尝试的解决方案
+- 执行完成时：记录完成状态和实际变更摘要
+
+长度不超过 TEAM.md 的 `memory.workspace_limit` 配置。
+
+## 角色记忆回顾
+
+执行完成后，角色回顾本次工作：
+
+1. 读取自己的记忆文件
+2. 判断是否有值得记录的跨任务经验（技术陷阱、模块特殊知识等）
+3. 如有，检查记忆是否超限，超限则压缩后写回
+4. 如无新经验，不写入
+
 ## 进化感知（工具缺口）
 
 执行过程中，主动检测是否存在工具缺口：

package/skills/ys-team-status/SKILL.md

@@ -17,14 +17,16 @@ Use it to display the live ys-team state of a repository.
 
 ## Behavior
 
-1. 读取 `.ys_team/status.md`
-2. 如果文件不存在或 `updated` 为空（`—`），提示："团队状态尚未初始化。首次执行 spec-talk 或 spec-work 后，状态会自动更新。"
-3. 如果文件存在且有数据，格式化输出：
-   - 活跃 Spec 列表
+1. 读取 `TEAM.md`（如存在，获取当前 mode 配置）
+2. 读取 `.ys_team/status.md`
+3. 如果文件不存在或 `updated` 为空（`—`），提示："团队状态尚未初始化。首次执行 spec-talk 或 spec-work 后，状态会自动更新。"
+4. 如果文件存在且有数据，格式化输出：
+   - 当前模式（manual / semi-auto / full-auto）
+   - 活跃 Spec 列表（含状态机当前状态和重试次数）
    - 最新判断（最近 5 条）
    - 阻塞项（高亮显示）
    - 待办事项
-4. 检查 `.ys_team/VERSION` 与 baseline 版本对齐
+5. 检查 `.ys_team/VERSION` 与 baseline 版本对齐
 
 ## Version Notice
 
@@ -60,8 +62,12 @@ updated: [ISO 8601 时间戳]
 
 ## 活跃 Spec
 
-| Spec | 阶段 | 负责角色 | 状态 |
-|------|------|---------|------|
+| Spec | 阶段 | 状态 | 负责角色 | 重试次数 | 模式 |
+|------|------|------|---------|---------|------|
+
+### 状态值
+
+- idle / spec-talk / spec-review / spec-work / qa / close / done / halt
 
 ## 最新判断
 

package/skills/ys-team-submit/SKILL.md

@@ -9,6 +9,8 @@ This is a silent internal skill.
 
 Use it when a repository needs a heavier delivery gate.
 
+**注意**：submit 只负责验收判断，不负责关闭动作。关闭（git commit、状态更新为 done）由编排器的 close 阶段执行。
+
 ## Purpose
 
 - review spec acceptance against actual delivery
@@ -21,6 +23,24 @@ Use it when a repository needs a heavier delivery gate.
 - focus on delivery truth, not optimistic summary
 - call out missing evidence or unsynced docs clearly
 - prefer explicit PASS/BLOCKED/REJECT outcomes
+- **不执行关闭动作**——判断完成后输出结论，由编排器决定下一步
+
+## Read Order
+
+1. `TEAM.md`（如存在）
+2. 当前 spec 的 `control.md`（验收合约）
+3. 当前 spec 的 `work.md`（执行记录）
+4. 当前 spec 的 `workspace.md`（工作记忆）
+5. delivery-guard 的记忆文件（`.ys_team/memory/roles/delivery-guard.md`）
+6. `.ys_team/policy.md`（submit gate 规则）
+
+## 角色记忆回顾
+
+验收完成后，delivery-guard 回顾本次验收：
+
+1. 读取自己的记忆文件
+2. 判断是否有值得记录的验收经验
+3. 如有，检查记忆是否超限，超限则压缩后写回
 
 ## Status 写入