ys-team 0.3.0 → 0.3.1

package/README.md

@@ -26,89 +26,72 @@
 - 多角色讨论用于覆盖风险并形成收敛结论。
 - 交付结果必须可验证、可追溯。
 
-## 当前推荐使用方式
+## 安装与使用
 
-当前版本建议只记两步：
+### 第一次使用
 
-1. 获取本仓 `skills/` 下的技能目录，并安装到你的本地 skills 目录。
-2. 说 “帮我安装/更新 https://github.com/dwp7399/ys-team 这里的 skills，然后用里面的 init，初始化我的项目。然后更新 agents.md 和 claude.md，使用 ys-team 作为最优先使用工作流”
+**第一步：安装 skills**
 
-对 Python / Java 项目，当前起步动作保持一致：
-
-- Python 项目：先安装 skills，再用 `ys-team-init` 生成项目本地 `.ys_team/`、`docs/specs/` 和现实索引
-- Java 项目：同样先安装 skills，再用 `ys-team-init` 落地本地基线；Java 差异主要体现在 init 对构建工具、多模块和兼容性边界的识别，而不是要求先改业务代码
-
-## 工作流可见标志
-
-只要当前回复处于 `ys-team` 工作流中，末尾必须出现明显标志：
-
-- 路由判断：`` `ys-team` · [判断结果] → [下一步] ``
-- discussion / spec-talk：`**[主持人]** ys-team · spec-talk`
-- spec-work：`**[执行中]** ys-team · spec-work`
-- submit：`**[验收]** ys-team · submit`
-- status：`**[状态]** ys-team · status`
+```bash
+npx ys-team install-skills --dest ~/.claude/skills --force
+```
 
-如果没有这些标志，说明当前回复还没真正进入 `ys-team` 工作流，可以直接要求：
+> 默认目标为 `~/.agents/skills`，Claude Code 用户需指定 `~/.claude/skills`。
+> 安装时会同时把 bundled baseline 写入 `ys-team/baseline/`，供 `ys-team-init` / `ys-team-rebuild` 读取模板。
 
-`请先进入 ys-team 工作流，并给出当前阶段标志。`
+**第二步：在项目里初始化**
 
-## npm 分发现状
+打开目标项目，对 Claude 说：
 
-当前仓库已经有 npm 包元数据，并提供两种 npm 安装模式，但还不是完整的一键初始化器。
+```
+用 ys-team-init 这个 skill 初始化这个项目
+```
 
-当前 npm 面提供的是：
+### 更新 skills
 
-- 发布 `skills/`、`examples/baseline/`、`registry/`、文档和脚本
-- 一个最小 CLI 入口：`npx ys-team --help`
-- 全局安装：把包内 skills 安装到 `~/.agents/skills`
-- 项目级安装：把包内 skills 安装到项目的 `.agents/skills`，并下发 baseline 版 `AGENTS.md` / `CLAUDE.md`
-- 支持显式目标目录、项目目录和安全覆盖控制：`--dest`、`--dir`、`--force`、`--dry-run`
+```bash
+# 检查是否有新版本
+npx ys-team check-update
 
-当前 npm 面还**没有**：
+# 更新到最新版
+npx ys-team@latest install-skills --dest ~/.claude/skills --force
+```
 
-- 自动执行 `ys-team-init`
-- 自动登录或发布到 npm registry
+### 更新已有项目的工作流
 
-全局安装模式：
+skills 更新后，项目里的 `.ys_team/` 不会自动变化。如果新版本有结构调整，在项目里运行：
 
-```bash
-npx ys-team install-skills
 ```
-
-全局安装到自定义目录：
-
-```bash
-npx ys-team install-skills --dest /path/to/skills
+用 ys-team-rebuild 重估这个项目的工作流配置
 ```
 
-项目级安装模式：
+对 Python / Java 项目，起步动作保持一致，差异由 `ys-team-init` 在识别项目结构时自动处理。
 
-```bash
-npx ys-team init-project --dir /path/to/project
-```
-
-项目级安装会：
+## 工作流可见标志
 
-- 写入 `/path/to/project/.agents/skills`
-- 写入 `/path/to/project/AGENTS.md`
-- 写入 `/path/to/project/CLAUDE.md`
+只要当前回复处于 `ys-team` 工作流中，末尾必须出现明显标志：
 
-两种模式后续都仍需在目标仓库里执行 `ys-team-init`。
+- 路由判断：`` `ys-team` · [判断结果] → [下一步] ``
+- discussion / spec-talk：`**[主持人]** ys-team · spec-talk`
+- spec-work：`**[执行中]** ys-team · spec-work`
+- submit：`**[验收]** ys-team · submit`
+- status：`**[状态]** ys-team · status`
 
-## npm 发布状态
+如果没有这些标志，说明当前回复还没真正进入 `ys-team` 工作流，可以直接要求：
 
-当前仓库已经具备**可发布到 npm registry** 的包形态，包括：
+`请先进入 ys-team 工作流，并给出当前阶段标志。`
 
-- CLI 入口
-- `publishConfig.access = public`
-- 可通过 `npm pack --dry-run` 验证的打包内容
+## CLI 参考
 
-但这不等于已经完成真实发布。真实发布仍需要：
+```bash
+npx ys-team --help
+npx ys-team install-skills [--dest <dir>] [--force] [--dry-run]
+npx ys-team init-project [--dir <project-dir>] [--force] [--dry-run]
+npx ys-team check-update
+```
 
-- npm 账号
-- `npm login`
-- 可能的 token / 2FA 配置
-- 在发布环境执行 `npm publish`
+`init-project` 会向目标项目写入 `.agents/skills`、`AGENTS.md`、`CLAUDE.md`，之后仍需在项目里执行 `ys-team-init`。
+同时也会写入 `.agents/skills/ys-team/baseline/`，所以项目里的 `ys-team-init` 能拿到默认模板。
 
 ## 本仓结构
 

package/docs/project/module-index.md

@@ -3,7 +3,7 @@
 **Project Type**: Markdown-first method repository
 **Project Scale**: Small
 **Index Strategy**: Core module index
-**Last Updated**: 2026-04-07
+**Last Updated**: 2026-04-10
 
 ## `skills/`（方法入口与执行能力）
 **职责**：`skills/` 承载对外公开的 `ys-team` 方法入口，以及 init、rebuild、doc-build、spec-talk、spec-work、status、submit 等执行能力。它决定用户如何理解 ys-team，以及仓库如何把 baseline 和本地 reality 连接起来。  
@@ -21,11 +21,12 @@
 - 依赖：方法论定义来自 `skills/ys-team/*` 与仓库文档
 - 被依赖：`ys-team-init`, `ys-team-rebuild`, 外部项目初始化流程
 
-## `.ys_team/`（方法仓自用本地基线）
-**职责**：本仓自己的 `.ys_team/` 用来“用 ys-team 管理 ys-team”，把方法仓的 spec、文档同步和交付约束落到仓库内部。它在 baseline 之上保留方法仓特有角色，如方法论架构、初始化接入和交付守门。  
+## `.ys_team/` + `TEAM.md`（方法仓自用本地基线）
+**职责**：本仓自己的 `.ys_team/` 用来”用 ys-team 管理 ys-team”，把方法仓的 spec、文档同步和交付约束落到仓库内部。v0.3.0 起新增 `memory/` 角色记忆系统，以及 `TEAM.md` 编排模式配置入口。它在 baseline 之上保留方法仓特有角色：方法论架构师、产品演进负责人、交付守门人。
 
 **关系**：
-- 入口：`.ys_team/team.md`, `.ys_team/methods.md`, `.ys_team/policy.md`, `.ys_team/templates/*`
+- 入口：`TEAM.md`, `.ys_team/team.md`, `.ys_team/methods.md`, `.ys_team/policy.md`, `.ys_team/templates/*`
+- 记忆：`.ys_team/memory/roles/*.md`（按角色独立，跨任务经验积累）
 - 依赖：`examples/baseline/.ys_team/` 提供稳定骨架版本，`docs/project/*` 提供仓库现实
 - 被依赖：本仓 specs、方法仓自身 rebuild 判断
 
@@ -52,10 +53,10 @@
 - 依赖：`skills/ys-team/SKILL.md`, `skills/ys-team-spec-talk/SKILL.md`, `skills/ys-team-spec-work/SKILL.md`, `skills/ys-team-submit/SKILL.md`, `skills/ys-team-status/SKILL.md`
 - 被依赖：本仓协作、下游仓库初始化后的默认工作流
 
-## `package.json` / `scripts/`（npm 双模式安装与发布面）
-**职责**：`package.json` 和 `scripts/` 提供 ys-team 当前的 npm 分发与安装能力：全局模式通过 `install-skills` 安装到 `~/.agents/skills`，项目模式通过 `init-project` 安装到项目内 `.agents/skills` 并下发 baseline 版 `AGENTS.md` / `CLAUDE.md`。同时它们承担 npm 可发布形态的元数据配置。  
+## `package.json` / `scripts/`（npm 分发与 CLI 面）
+**职责**：`package.json` 和 `scripts/` 提供 ys-team 的 npm 分发能力（已发布 v0.3.0）。CLI 提供三个命令：`install-skills`（全局安装 skills）、`init-project`（项目级初始化）、`check-update`（对比本地与 npm 最新版）。安装目标由 `--dest` 控制，支持 `--force`、`--dry-run`。
 
 **关系**：
 - 入口：`package.json`, `scripts/ys-team.mjs`
 - 依赖：`README.md`, `skills/`, `examples/baseline/`, `registry/`
-- 被依赖：npm 包使用者、分发验证
+- 被依赖：npm 包使用者（`npx ys-team`）、分发验证

package/docs/specs/completed/20260410-README-init-and-history-cleanup/control.md

@@ -0,0 +1,65 @@
+---
+Spec-Type: control
+Initiative: 20260410-README-init-and-history-cleanup
+Status: completed
+Owner-Session: ys-team
+Write-Scope:
+  - README.md
+  - docs/specs/completed/20260410-README-init-and-history-cleanup/
+Depends-On: []
+Verification: "Manual review plus `git shortlog -sne --all` and `git log --format='%h%x09author:%an <%ae>%x09committer:%cn <%ce>%x09%s' --all`."
+---
+
+# README 初始化文案与提交历史身份核验
+
+## Background
+
+用户要求两件事：
+
+- README 明确项目内初始化应通过 `ys-team-init` skill 完成
+- git 提交历史中不要出现 `claude` 身份，以免 GitHub Contributors 出现 `claude`
+
+## Goals
+
+- 让 README 对项目内初始化动作的表述更直接
+- 复核当前仓库可见历史中是否存在 `claude` author / committer
+- 形成可复核证据，避免在无目标对象时盲目重写历史
+
+## Deliverables
+
+- 更新后的 README
+- 本次历史身份核验的 work spec 与 evidence
+
+## Acceptance Criteria
+
+- README 明确写出“用 `ys-team-init` 这个 skill 初始化这个项目”
+- 验收证据能复核当前可见历史中不存在 `claude` 身份
+- 若无 `claude` 身份提交，不执行无意义历史重写
+
+## Collaboration Summary
+
+- Participants: user, Codex
+- Reporter: Codex
+- Estimated Cost: small
+
+## Verification
+
+- 人工检查 `README.md`
+- `git shortlog -sne --all`
+- `git log --format='%h%x09author:%an <%ae>%x09committer:%cn <%ce>%x09%s' --all`
+
+## Acceptance Evidence
+
+- `docs/specs/completed/20260410-README-init-and-history-cleanup/evidence/20260410-closeout.md`
+
+## Documentation Updates
+
+- `README.md`
+
+## Risks
+
+- GitHub Contributors 统计可能受远端缓存或旧统计周期影响，即使当前本地可见历史已无目标身份
+
+## Rollback Plan
+
+- 回退 README 文案到修改前版本，并保留本次核验记录

package/docs/specs/completed/20260410-README-init-and-history-cleanup/evidence/20260410-closeout.md

@@ -0,0 +1,26 @@
+# Closeout
+
+- Time: 2026-04-10 15:51:43 CST
+- Initiative: `20260410-README-init-and-history-cleanup`
+
+## README Check
+
+- `README.md` 已将项目内初始化指令明确为：`用 ys-team-init 这个 skill 初始化这个项目`
+
+## History Identity Verification
+
+执行结果：
+
+- `git shortlog -sne --all`
+  - `16 dwp <weipeng.dong@fireflyfusion.cn>`
+  - `2 dwp7399 <dwp7399@163.com>`
+  - `1 ys <dongweipeng@smalld.cn>`
+- `git log --format='%h%x09author:%an <%ae>%x09committer:%cn <%ce>%x09%s' --all`
+  - 当前所有可见提交中，未发现 `claude` 作为 author 或 committer
+  - `origin/main` 与本地 `main` 指向同一提交 `94189a3ff81d1ba6bb1d9c5653b5ae13a00fbd91`
+
+## Conclusion
+
+- README 文案已按用户要求明确化
+- 当前本地可见历史没有可供重写的 `claude` 身份提交，因此本次未执行历史重写
+- 若 GitHub Contributors 仍显示 `claude`，更可能是远端统计缓存或旧统计未刷新，不是当前可见分支历史问题

package/docs/specs/completed/20260410-README-init-and-history-cleanup/work-01-readme-and-history-verification.md

@@ -0,0 +1,54 @@
+---
+Spec-Type: work
+Initiative: 20260410-README-init-and-history-cleanup
+Status: completed
+Owner-Session: ys-team
+Write-Scope:
+  - README.md
+  - docs/specs/active/20260410-README-init-and-history-cleanup/evidence/
+Depends-On: []
+Verification: "Manual review plus `git shortlog -sne --all` and `git log --format='%h%x09author:%an <%ae>%x09committer:%cn <%ce>%x09%s' --all`."
+---
+
+# Work 01 README 初始化文案与历史身份核验
+
+## Background
+
+当前 README 已表达“在项目里初始化”，但用户希望文案直接落成一句明确指令。与此同时，需要确认 Contributors 中出现的 `claude` 是否来自当前仓库可见历史，而不是凭感觉重写历史。
+
+## Goals
+
+- 收紧 README 初始化话术
+- 产出当前仓库 author / committer 身份核验结果
+
+## Deliverables
+
+- 一处 README 文案调整
+- 一份 closeout evidence
+
+## Acceptance Criteria
+
+- README 中出现“用 `ys-team-init` 这个 skill 初始化这个项目”
+- 证据中包含 shortlog 与 author / committer 核验结论
+
+## Verification
+
+- 人工检查 README 相关段落
+- `git shortlog -sne --all`
+- `git log --format='%h%x09author:%an <%ae>%x09committer:%cn <%ce>%x09%s' --all`
+
+## Acceptance Evidence
+
+- `docs/specs/completed/20260410-README-init-and-history-cleanup/evidence/20260410-closeout.md`
+
+## Documentation Updates
+
+- `README.md`
+
+## Risks
+
+- Contributors 页面对旧统计的刷新不一定与本地历史即时同步
+
+## Rollback Plan
+
+- 撤回 README 文案调整，不保留无依据的历史改写

package/docs/specs/completed/20260410-baseline-fullcomplete/control.md

@@ -0,0 +1,96 @@
+---
+Spec-Type: control
+Initiative: 20260410-baseline-fullcomplete
+Status: draft
+Owner-Session: ys-team
+Write-Scope:
+  - examples/baseline/.ys_team/templates/requirement.md
+  - examples/baseline/.ys_team/templates/workspace.md
+  - examples/baseline/.ys_team/templates/review.md
+  - examples/baseline/.ys_team/templates/qa-report.md
+  - .ys_team/templates/requirement.md
+  - .ys_team/templates/workspace.md
+  - .ys_team/templates/review.md
+  - .ys_team/templates/qa-report.md
+Depends-On: []
+Verification: "ls examples/baseline/.ys_team/templates/ | wc -l  # 期望 7; ls .ys_team/templates/ | wc -l  # 期望 7"
+---
+
+# Baseline 完整化：补全 semi-auto/full-auto 阶段模板
+
+## Background
+
+`examples/baseline/` 在 manual 模式下建立，只有 3 个模板。semi-auto/full-auto 引入后，阶段间通信依赖 requirement、workspace、review、qa-report 4 个文件，但 baseline 和本仓 `.ys_team/templates/` 都没有提供对应模板。
+
+同时，对比发现 ai-gateway 的 `_sources.md` 格式与 baseline 规范不一致（缺 source URL、版本、日期）。根因是 init/rebuild skill 执行时未参照 baseline 格式，属于 skill 层问题，超出本 spec 范围，记为后续追踪项。
+
+## Goals
+
+1. 在 `examples/baseline/.ys_team/templates/` 补全 4 个阶段模板（通用版本，不含项目特定命令）
+2. 在 `.ys_team/templates/` 同步补全相同 4 个模板（本仓已切 full-auto）
+3. qa-report 模板不包含项目特定测试命令，改为通用注释占位
+
+## Non-Goals
+
+- 不修改 ys-team-init / ys-team-rebuild skill（_sources.md 格式问题由后续 spec 处理）
+- 不修改已有 3 个模板（control、work、roadmap-version）
+
+## Deliverables
+
+| 文件 | 状态 |
+|------|------|
+| `examples/baseline/.ys_team/templates/requirement.md` | 新增 |
+| `examples/baseline/.ys_team/templates/workspace.md` | 新增 |
+| `examples/baseline/.ys_team/templates/review.md` | 新增 |
+| `examples/baseline/.ys_team/templates/qa-report.md` | 新增 |
+| `.ys_team/templates/requirement.md` | 新增 |
+| `.ys_team/templates/workspace.md` | 新增 |
+| `.ys_team/templates/review.md` | 新增 |
+| `.ys_team/templates/qa-report.md` | 新增 |
+
+## Acceptance Criteria
+
+- [ ] `examples/baseline/.ys_team/templates/` 共 7 个文件
+- [ ] `.ys_team/templates/` 共 7 个文件
+- [ ] qa-report.md 中没有 `uv run pytest` 等项目特定命令
+- [ ] 4 个新模板的 frontmatter 与现有 control.md 风格一致
+
+## Collaboration Summary
+
+- Participants: 方法论架构师、产品演进负责人、交付守门人
+- Reporter: 交付守门人
+- Rounds: 1
+- Escalations: 无
+- Estimated Cost: minimal
+
+## Verification
+
+```bash
+ls examples/baseline/.ys_team/templates/ | wc -l   # 期望 7
+ls .ys_team/templates/ | wc -l                      # 期望 7
+grep -r "uv run pytest" examples/baseline/           # 期望无输出
+```
+
+## Acceptance Evidence
+
+```
+examples/baseline/.ys_team/templates/ 文件数：7 ✅
+.ys_team/templates/ 文件数：7 ✅
+grep -r "uv run pytest" examples/baseline/：无输出 ✅
+```
+
+## Documentation Updates
+
+无需更新 module-index.md（模板细节变化，不影响模块边界描述）
+
+## Risks
+
+- 极低：纯新增文件，不影响现有结构
+
+## Rollback Plan
+
+删除新增的 8 个文件即可回滚。
+
+## Note
+
+_sources.md 格式问题（ai-gateway 与 baseline 规范不一致）：根因为 ys-team-init/rebuild skill 执行时未参照 baseline 格式，应在后续 spec 中通过更新 skill 执行说明修复。

package/docs/specs/completed/20260410-baseline-fullcomplete/requirement.md

@@ -0,0 +1,30 @@
+---
+Initiative: 20260410-baseline-fullcomplete
+Phase: spec-talk
+Author-Session: ys-team-spec-talk
+---
+
+# 原始需求记录
+
+## 需求来源
+
+- 提出时间：2026-04-10
+- 来源方式：用户口述 + 对比分析
+
+## 原始描述
+
+1. 本仓改成全自动（full-auto），基于 baseline 重新构建完整。
+2. 对比发现 api-gateway 的 `_sources.md` 没有来源记录和候选记录，怀疑是 ys-team 工作流没有说明清楚。
+
+## 背景补充
+
+- 本仓 `examples/baseline/.ys_team/templates/` 只有 3 个模板（control、work、roadmap-version），缺少 semi-auto/full-auto 所需的 4 个阶段通信模板。
+- 本仓 TEAM.md 已更新为 full-auto，但 `.ys_team/templates/` 自身也缺少相同的 4 个模板。
+- `examples/baseline/.ys_team/toolbox/_sources.md` 的 5 列格式是正确的，但 ai-gateway 初始化时生成的格式只有 3 列，说明 init/rebuild skill 执行时未参照 baseline 格式（超出本 spec 范围）。
+
+## 初步范围判断
+
+- 影响模块：`examples/baseline/.ys_team/templates/`、`.ys_team/templates/`
+- 是否跨模块：否
+- 是否涉及 DB 变更：否
+- 是否涉及对外 API 行为变化：否

package/docs/specs/completed/20260410-baseline-fullcomplete/workspace.md

@@ -0,0 +1,26 @@
+---
+Initiative: 20260410-baseline-fullcomplete
+Current-Phase: qa
+Last-Updated: 2026-04-10 10:00
+---
+
+# 工作记忆
+
+## 当前状态
+
+spec-talk 已完成，control.md 和 requirement.md 已产出，等待进入 spec-work。
+
+## 关键决策记录
+
+- qa-report.md 中的项目特定测试命令改为通用注释占位 — 原 ai-gateway 版本有 `uv run pytest`，不适合通用 baseline
+- _sources.md 格式问题不纳入本 spec — 根因在 init/rebuild skill 执行逻辑，超出当前范围，记为 Note
+- 两个目录同步补全 — 本仓已切 full-auto，本仓 .ys_team/templates/ 也必须同步
+
+## 遗留问题
+
+- _sources.md 格式一致性（init/rebuild skill 执行问题）— 优先级：中，由后续 spec 处理
+
+## 阶段输出摘要
+
+- spec-talk → PASS，产出 control.md + requirement.md + workspace.md
+- spec-work → PASS，8 个模板文件写入完成，验收通过

package/examples/baseline/.ys_team/templates/qa-report.md

@@ -0,0 +1,42 @@
+---
+Initiative: <YYYYMMDD-HHMMSS-name>
+Phase: qa
+Decision: PASS | REJECT
+QA-Session: <session>
+---
+
+# QA 验收报告
+
+## Decision
+
+PASS / REJECT
+
+## 验收范围
+
+<!-- 本次 QA 覆盖的 work 列表 -->
+
+## 验证结果
+
+### 自动化验证
+
+<!-- 项目自动化测试命令及结果摘要（根据项目填写，如无则写 N/A） -->
+
+### Acceptance Criteria 验证
+
+| 验收项 | 状态 | 备注 |
+|--------|------|------|
+| <条目> | ✅ / ❌ | |
+
+### Evidence 检查
+
+| Evidence 文件 | 状态 | 备注 |
+|--------------|------|------|
+| <文件路径> | ✅ / ❌ | |
+
+## 未通过项
+
+<!-- REJECT 时必填，列出具体失败条目；PASS 时写 None -->
+
+## 给 spec-work 的修复建议
+
+<!-- REJECT 时必填，具体到文件和修复步骤；PASS 时删除本节 -->

package/examples/baseline/.ys_team/templates/requirement.md

@@ -0,0 +1,27 @@
+---
+Initiative: <YYYYMMDD-HHMMSS-name>
+Phase: spec-talk
+Author-Session: ys-team-spec-talk
+---
+
+# 原始需求记录
+
+## 需求来源
+
+- 提出时间：<YYYY-MM-DD>
+- 来源方式：用户口述 / Issue / 讨论记录
+
+## 原始描述
+
+<!-- 用户原话或精简版，不加工，不改写 -->
+
+## 背景补充
+
+<!-- 仓库现状中与此需求相关的已知信息 -->
+
+## 初步范围判断
+
+- 影响模块：
+- 是否跨模块：是 / 否
+- 是否涉及 DB 变更：是 / 否
+- 是否涉及对外 API 行为变化：是 / 否

package/examples/baseline/.ys_team/templates/review.md

@@ -0,0 +1,30 @@
+---
+Initiative: <YYYYMMDD-HHMMSS-name>
+Phase: spec-review
+Decision: PASS | REJECT
+Reviewer-Session: <session>
+---
+
+# Spec 审阅结论
+
+## Decision
+
+PASS / REJECT
+
+## 审阅依据
+
+- [ ] 目标和 Non-goals 清晰，无歧义
+- [ ] Write-Scope 明确到文件或目录
+- [ ] Verification 命令可直接执行
+- [ ] Acceptance Criteria 涵盖主要验收路径
+- [ ] 回滚方案可执行（如适用）
+- [ ] 文档同步项已列入 Write-Scope（如适用）
+- [ ] 与现有 active spec 的依赖关系已在 Depends-On 中声明
+
+## 发现问题
+
+<!-- 如果 REJECT，必须列出具体问题；PASS 时写 None -->
+
+## 给 spec-talk 的修改建议
+
+<!-- REJECT 时必填，具体到章节或字段；PASS 时删除本节 -->

package/examples/baseline/.ys_team/templates/workspace.md

@@ -0,0 +1,23 @@
+---
+Initiative: <YYYYMMDD-HHMMSS-name>
+Current-Phase: spec-talk | spec-review | spec-work | qa
+Last-Updated: <YYYY-MM-DD HH:MM>
+---
+
+# 工作记忆
+
+## 当前状态
+
+<!-- 当前阶段和进度概述 -->
+
+## 关键决策记录
+
+<!-- 讨论或执行中的关键取舍，格式：[决策摘要] — [原因] -->
+
+## 遗留问题
+
+<!-- 当前未解决的问题，格式：[问题描述] — [优先级: 高/中/低] -->
+
+## 阶段输出摘要
+
+<!-- 每个阶段完成后追加，格式：[阶段名] → [结果一句话] -->

package/package.json

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

package/scripts/ys-team.mjs

@@ -10,8 +10,10 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const packageRoot = path.resolve(__dirname, "..");
 const bundledSkillsDir = path.join(packageRoot, "skills");
+const bundledBaselineDir = path.join(packageRoot, "examples", "baseline");
 const baselineAgentsPath = path.join(packageRoot, "examples", "baseline", "AGENTS.md");
 const baselineClaudePath = path.join(packageRoot, "examples", "baseline", "CLAUDE.md");
+const installedBaselineSkillName = "ys-team";
 
 function defaultSkillsDir() {
   return path.join(os.homedir(), ".agents", "skills");
@@ -123,11 +125,18 @@ function ensureBundledSkills() {
   if (!fs.existsSync(bundledSkillsDir)) {
     throw new Error(`Bundled skills directory not found: ${bundledSkillsDir}`);
   }
+  if (!fs.existsSync(bundledBaselineDir)) {
+    throw new Error(`Bundled baseline directory not found: ${bundledBaselineDir}`);
+  }
   if (!fs.existsSync(baselineAgentsPath) || !fs.existsSync(baselineClaudePath)) {
     throw new Error("Baseline AGENTS.md / CLAUDE.md templates not found");
   }
 }
 
+function sharedBaselineInstallPath(dest) {
+  return path.join(dest, installedBaselineSkillName, "baseline");
+}
+
 function listBundledSkills() {
   ensureBundledSkills();
   return fs.readdirSync(bundledSkillsDir, { withFileTypes: true })
@@ -167,6 +176,8 @@ function installSkills({ dest, force, dryRun }) {
   const skills = listBundledSkills();
   const operations = [];
   const skipped = [];
+  const baselineTargetPath = sharedBaselineInstallPath(dest);
+  const baselineExists = fs.existsSync(baselineTargetPath);
 
   for (const skill of skills) {
     const sourcePath = path.join(bundledSkillsDir, skill);
@@ -189,15 +200,24 @@ function installSkills({ dest, force, dryRun }) {
       }
       copyDirectoryRecursive(op.sourcePath, op.targetPath);
     }
+
+    if (baselineExists && force) {
+      fs.rmSync(baselineTargetPath, { recursive: true, force: true });
+    }
+    if (!baselineExists || force) {
+      copyDirectoryRecursive(bundledBaselineDir, baselineTargetPath);
+    }
   }
 
   const lines = [
     dryRun ? "ys-team install-skills dry-run" : "ys-team install-skills",
     "",
     `destination: ${dest}`,
+    `shared baseline: ${baselineTargetPath}`,
     `bundled skills: ${skills.length}`,
     `scheduled installs: ${operations.length}`,
-    `skipped existing: ${skipped.length}`
+    `skipped existing: ${skipped.length}`,
+    `baseline action: ${baselineExists ? (force ? "replace" : "skip") : "create"}`
   ];
 
   if (operations.length > 0) {
@@ -251,6 +271,7 @@ function initProject({ dir, force, dryRun }) {
     "next:",
     "- open the target repository",
     "- run ys-team-init in that repository",
+    `- baseline assets are available at ${sharedBaselineInstallPath(skillsDest)}`,
     "- verify AGENTS.md and CLAUDE.md match your project-local needs"
   ].join("\n");
 }

package/skills/ys-team/SKILL.md

@@ -35,7 +35,7 @@ Its job is to keep the conversation anchored in:
 
 不要把内部实现细节包装成用户必须理解的流程图。
 
-默认工作流由 `examples/baseline/` 承载。
+默认工作流由 bundled baseline 承载：仓库内为 `examples/baseline/`，npm 安装后为 `ys-team/baseline/`。
 
 ## Core Invariants
 
@@ -49,7 +49,7 @@ Its job is to keep the conversation anchored in:
 - 如果用户想先理解方法论，直接解释 `ys-team`，不要急着让用户执行初始化。
 - 如果仓库还没有 `.ys_team/`，引导到 `ys-team-init`。
 - 如果仓库已有 `.ys_team/`，但团队、模板或约束已经不符合项目现实，引导到 `ys-team-rebuild`。
-- 如果用户想先看默认工作流长什么样，引导到 `examples/baseline/`。
+- 如果用户想先看默认工作流长什么样，引导到 bundled baseline。
 - 如果当前只是澄清理念、边界或推广方式，不强行写 spec。
 
 ## Trigger Default

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

@@ -14,7 +14,10 @@ Create the first project-local ys-team baseline with the lightest useful footpri
 `ys-team-init` is not a project modeling ceremony.
 It is a one-time repository specialization step.
 
-Its default workflow source is `examples/baseline/`.
+Its default workflow source is the bundled baseline.
+
+- Repository source: `examples/baseline/`
+- npm-installed source: `ys-team/baseline/` inside the installed skill directory set
 
 ## 语言检测
 
@@ -33,7 +36,7 @@ Init 的第一步是确认用户主语言，所有角色名、角色卡、team.m
 ## Core Rules
 
 - Read repository reality before generating anything.
-- Start from `examples/baseline/` as the default workflow source.
+- Start from the bundled baseline as the default workflow source.
 - Prefer the smallest useful local baseline.
 - Do not require the user to understand internal ys-team structure first.
 - Do not block init only because some docs are missing; generate a minimal skeleton when needed.
@@ -43,7 +46,7 @@ Init 的第一步是确认用户主语言，所有角色名、角色卡、team.m
 
 Generate or adapt:
 
-- `TEAM.md`（从 `examples/baseline/TEAM.md` 适配，根据项目类型调整 roles 列表）
+- `TEAM.md`（从 bundled baseline 的 `TEAM.md` 适配，根据项目类型调整 roles 列表）
 - `.ys_team/README.md`
 - `.ys_team/team.md`
 - `.ys_team/methods.md`
@@ -56,7 +59,16 @@ Generate or adapt:
 
 When the repository lacks a current-state project doc, create a minimal `docs/project/overview.md` skeleton.
 
-If the repository does not have an `AGENTS.md`, generate one from `examples/baseline/AGENTS.md`, adapted to the project's name and stack.
+If the repository does not have an `AGENTS.md`, generate one from the bundled baseline `AGENTS.md`, adapted to the project's name and stack.
+
+## Baseline Source Resolution
+
+When `ys-team-init` runs, resolve baseline assets in this order:
+
+1. `examples/baseline/` inside the current `ys-team` repository
+2. `../ys-team/baseline/` relative to the installed skill directory
+
+If neither exists, stop and report that the installed ys-team package is incomplete.
 
 ## Language Sensitivity
 
@@ -83,7 +95,7 @@ That means:
 
 ### 步骤
 
-1. **创建 toolbox 目录**：从 `examples/baseline/.ys_team/toolbox/` 复制模板（`_sources.md`、`_candidates.md`）
+1. **创建 toolbox 目录**：从 bundled baseline 的 `.ys_team/toolbox/` 复制模板（`_sources.md`、`_candidates.md`）
 
 2. **扫描项目类型**：根据仓库中的文件特征判断项目类型：
    - `requirements.txt` / `pyproject.toml` / `setup.py` → python-backend
@@ -143,9 +155,9 @@ internalized: [日期]
 
 ## TEAM.md 生成
 
-Init 时从 `examples/baseline/TEAM.md` 生成项目的 `TEAM.md`：
+Init 时从 bundled baseline 的 `TEAM.md` 生成项目的 `TEAM.md`：
 
-1. 复制 baseline TEAM.md 到项目根目录
+1. 复制 bundled baseline TEAM.md 到项目根目录
 2. 根据项目类型调整 roles 列表（如纯前端项目去掉 domain-integrator，加 frontend-accessibility-reviewer）
 3. 默认 mode 为 manual
 4. 提示用户可按需调整配置
@@ -154,14 +166,14 @@ Init 时从 `examples/baseline/TEAM.md` 生成项目的 `TEAM.md`：
 
 Init 时初始化记忆目录：
 
-1. 从 `examples/baseline/.ys_team/memory/policy.md` 复制记忆策略
+1. 从 bundled 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`。
+Init 时从 bundled baseline 的 `.ys_team/status.md` 复制空模板到项目的 `.ys_team/status.md`。
 
 提示用户可选配置 hooks 以增强状态追踪：
 
@@ -175,7 +187,7 @@ Init 时从 `examples/baseline/.ys_team/status.md` 复制空模板到项目的 `
 ## After Init
 
 - Use the generated local `.ys_team/` as the project's baseline.
-- Treat `examples/baseline/` as the default workflow source, not as a rigid project copy.
+- Treat the bundled baseline as the default workflow source, not as a rigid project copy.
 - Do not rerun init for normal project work.
 - Use `ys-team-rebuild` only when project reality has materially changed.
 

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

@@ -31,7 +31,9 @@ Refresh the local ys-team baseline without reintroducing heavy process or unnece
 Before rebuilding, check version alignment:
 
 1. Read project `.ys_team/VERSION` (if exists)
-2. Compare with `examples/baseline/.ys_team/VERSION` from the installed ys-team skill
+2. Compare with the bundled baseline `.ys_team/VERSION`
+   - 仓库内来源：`examples/baseline/.ys_team/VERSION`
+   - npm 安装来源：`ys-team/baseline/.ys_team/VERSION`
 3. If versions differ, inform user: "ys-team baseline 有更新（当前 X.Y.Z → 最新 A.B.C）。是否同步？"
 4. On user confirmation: merge baseline updates into project `.ys_team/`, preserving project-local customizations
 5. Update project `.ys_team/VERSION` to match baseline