ys-team 0.2.0

package/AGENTS.md

@@ -0,0 +1,64 @@
+# ys-team Repository Instructions
+
+本仓用于沉淀 `ys-team` 方法论、skills、模板和示例文档，目标是为不同技术栈项目提供低侵入接入方式。
+
+## 最高优先级工作流
+
+本仓库使用 `ys-team` 排他工作流。
+
+**任何请求必须先经过 `ys-team` 路由。**
+
+**如果当前回复末尾没有出现 `ys-team` 可见标志，视为不在 ys-team 工作流中，必须立即切回路由。**
+
+## Primary Rule
+
+- 本仓自身使用 `ys-team`。
+- 所有非 trivial 改动先讨论，再以 `docs/specs/` 中的 spec 为准执行和验收。
+- 文档必须反映仓库当前真实状态；实现变化时，同次交付内同步更新。
+
+## Skill 排他规则
+
+**禁止自动触发 `.ys_team/toolbox/` 以外的任何 skill。**
+
+已内化的工具清单见 `.ys_team/toolbox/_sources.md`。
+仅这些工具的能力（以内化后的版本为准）在工作流中可用。
+
+用户如需临时使用未内化的 skill，必须显式指定（如 `/skill-name`）。
+此时 ys-team 记录该使用行为，作为下次 rebuild 的内化候选。
+
+## 例外
+
+用户在 CLAUDE.md 中显式声明的全局 skill 不受此规则限制。
+
+## 可见标志规则
+
+只要正在执行 `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`
+
+如果缺少这些标志，直接要求：
+
+`请先进入 ys-team 工作流，并给出当前阶段标志。`
+
+## Repository Scope
+
+- `skills/`：对外发布的 skill 包。
+- `.ys_team/`：本仓自用的 ys-team 本地工作流配置。
+- `docs/project/`：仓库现状、结构和方法论说明。
+- `docs/specs/`：本仓关于 ys-team 后续演进的 spec。
+
+## 现实索引
+
+项目现实索引位于 `docs/project/module-index.md`。
+
+在讨论影响范围、编写 spec 或评估改动风险时，先读取该索引，而不是直接探索代码库。
+
+## Delivery Rules
+
+- 默认优先保持方法论简洁，不堆叠过度解释。
+- skill 文案优先写"原则"和"边界"，避免把方法论写成硬流程。
+- README 面向使用者，文档要说明 Python / Java 项目如何低成本开始使用。

package/CLAUDE.md

@@ -0,0 +1,33 @@
+# CLAUDE.md
+
+本仓库默认使用 `ys-team` 排他工作流。
+
+## 第一优先级
+
+- 任何非 trivial 请求，先执行 `ys-team` 路由判断，再决定是 discussion、spec、work 还是 submit。
+- 如果当前回复没有出现 `ys-team` 可见标志，视为还没进入工作流；此时应立即切回 `ys-team` 路由。
+
+## 可见标志
+
+只要正在执行 `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`
+
+如果缺少这些标志，直接切回：
+
+`请先进入 ys-team 工作流，并给出当前阶段标志。`
+
+## 排他规则
+
+- 禁止自动触发 `.ys_team/toolbox/` 以外的任何 skill
+- 用户在本文件中显式声明的全局 skill 例外
+
+## 当前仓库约束
+
+- 现实索引优先读取 `docs/project/module-index.md`
+- 非 trivial 改动先讨论，再按 `docs/specs/` 执行和验收
+- 文档、skills、baseline 与状态文件必须同次交付同步

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ys
+
+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/README.md

@@ -0,0 +1,130 @@
+# ys-team
+
+`ys-team` 是一组用于组织 AI 员工工作的 skills，以及围绕这些 skills 的项目本地化方法论。
+
+当前仓库按三层组织：
+
+- `ys-team`：方法论本体
+- `examples/baseline/`：默认工作流骨架
+- `ys-team-init` / `ys-team-rebuild`：把默认骨架落到具体项目，或在项目变化后重估本地规则
+
+## The Zen of ys-team
+
+- 现实先于生成。
+- 规格先于执行。
+- 讨论归于收敛。
+- 证据胜于感觉。
+
+## 这是什么
+
+`ys-team` 不是固定流程图，也不是重型治理平台。
+
+它提供的是一组稳定约束：
+
+- 项目必须有能反映真实状态的共享现实索引。
+- 非 trivial 工作先收敛为 spec，再依据 spec 执行和验收。
+- 多角色讨论用于覆盖风险并形成收敛结论。
+- 交付结果必须可验证、可追溯。
+
+## 当前推荐使用方式
+
+当前版本建议只记两步：
+
+1. 获取本仓 `skills/` 下的技能目录，并安装到你的本地 skills 目录。
+2. 说 “帮我安装/更新 https://github.com/dwp7399/ys-team 这里的 skills，然后用里面的 init，初始化我的项目。然后更新 agents.md 和 claude.md，使用 ys-team 作为最优先使用工作流”
+
+对 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`
+
+如果没有这些标志，说明当前回复还没真正进入 `ys-team` 工作流，可以直接要求：
+
+`请先进入 ys-team 工作流，并给出当前阶段标志。`
+
+## npm 分发现状
+
+当前仓库已经有 npm 包元数据，并提供两种 npm 安装模式，但还不是完整的一键初始化器。
+
+当前 npm 面提供的是：
+
+- 发布 `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`
+
+当前 npm 面还**没有**：
+
+- 自动执行 `ys-team-init`
+- 自动登录或发布到 npm registry
+
+全局安装模式：
+
+```bash
+npx ys-team install-skills
+```
+
+全局安装到自定义目录：
+
+```bash
+npx ys-team install-skills --dest /path/to/skills
+```
+
+项目级安装模式：
+
+```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-init`。
+
+## npm 发布状态
+
+当前仓库已经具备**可发布到 npm registry** 的包形态，包括：
+
+- CLI 入口
+- `publishConfig.access = public`
+- 可通过 `npm pack --dry-run` 验证的打包内容
+
+但这不等于已经完成真实发布。真实发布仍需要：
+
+- npm 账号
+- `npm login`
+- 可能的 token / 2FA 配置
+- 在发布环境执行 `npm publish`
+
+## 本仓结构
+
+- `skills/`：对外发布的 ys-team skills
+- `examples/baseline/`：默认工作流骨架
+- `.ys_team/`：本仓自用工作流基线
+- `docs/project/`：仓库现状说明
+- `docs/specs/`：后续演进 spec
+
+其中 `skills/` 还包含一组静默内部能力，用于支撑默认工作流完整落地，但不要求用户主动理解或显式调用。
+
+## 当前边界
+
+当前仓库先收口四件事：
+
+- `ys-team` 的理念入口
+- `examples/baseline/` 的默认工作流表达
+- `ys-team-init` 的项目初始化职责
+- `ys-team-rebuild` 的本地规则重估职责

package/docs/project/module-index.md

@@ -0,0 +1,61 @@
+# Module Index
+
+**Project Type**: Markdown-first method repository
+**Project Scale**: Small
+**Index Strategy**: Core module index
+**Last Updated**: 2026-04-07
+
+## `skills/`（方法入口与执行能力）
+**职责**：`skills/` 承载对外公开的 `ys-team` 方法入口，以及 init、rebuild、doc-build、spec-talk、spec-work、status、submit 等执行能力。它决定用户如何理解 ys-team，以及仓库如何把 baseline 和本地 reality 连接起来。  
+
+**关系**：
+- 入口：`skills/ys-team/SKILL.md`, `skills/ys-team-init/SKILL.md`, `skills/ys-team-rebuild/SKILL.md`, `skills/ys-team-doc-build/SKILL.md`
+- 依赖：`examples/baseline/`, `.ys_team/`, `docs/project/`, `README.md`
+- 被依赖：使用 ys-team 的外部仓库、方法仓自测与演进
+
+## `examples/baseline/`（默认工作流骨架）
+**职责**：`examples/baseline/` 是 `ys-team-init` 和 `ys-team-rebuild` 的默认来源，提供最小公开心智下的 `.ys_team/` 结构和项目目录骨架。它不是具体项目实现，而是可被项目本地化的起点。  
+
+**关系**：
+- 入口：`examples/baseline/.ys_team/*`, `examples/baseline/AGENTS.md`, `examples/baseline/README.md`
+- 依赖：方法论定义来自 `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/methods.md`, `.ys_team/policy.md`, `.ys_team/templates/*`
+- 依赖：`examples/baseline/.ys_team/` 提供稳定骨架版本，`docs/project/*` 提供仓库现实
+- 被依赖：本仓 specs、方法仓自身 rebuild 判断
+
+## `docs/project/`（方法论现实与结构说明）
+**职责**：`docs/project/` 记录 ys-team 仓库现状、结构和模块职责，是本仓文档权威入口。它负责解释方法论仓库当前承载了哪些能力、哪些目录是对外骨架、哪些是仓库自用配置。  
+
+**关系**：
+- 入口：`docs/project/overview.md`, `docs/project/structure.md`, `docs/project/module-index.md`
+- 被依赖：`.ys_team/policy.md`, `skills/*/SKILL.md`, `README.md`
+
+## `README.md` / `AGENTS.md`（对外接入与协作口径）
+**职责**：`README.md` 面向用户解释 ys-team 的接入方式和公开心智，`AGENTS.md` 则约束仓库内 agent 协作规则。它们是方法仓从“定义”走向“使用”的外部表面。  
+
+**关系**：
+- 入口：`README.md`, `AGENTS.md`
+- 依赖：`skills/`, `examples/baseline/`, `docs/project/`
+- 被依赖：使用者、贡献者、仓库内协作流程
+
+## `CLAUDE.md` / `examples/baseline/AGENTS.md` / `examples/baseline/CLAUDE.md`（工作流可见标志下发面）
+**职责**：这一组文件把 `ys-team` 排他工作流和可见标志规则下发到仓库自身与 baseline 默认骨架中，让使用者能通过响应末尾标志判断当前是否真的处于 ys-team 工作流。  
+
+**关系**：
+- 入口：`CLAUDE.md`, `AGENTS.md`, `examples/baseline/AGENTS.md`, `examples/baseline/CLAUDE.md`
+- 依赖：`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/ys-team.mjs`
+- 依赖：`README.md`, `skills/`, `examples/baseline/`, `registry/`
+- 被依赖：npm 包使用者、分发验证

package/docs/project/npm-publish.md

@@ -0,0 +1,57 @@
+# npm 发布说明
+
+## 当前状态
+
+仓库当前已经具备 **可发布到 npm registry** 的包形态：
+
+- `package.json` 已声明 `bin`
+- `publishConfig.access` 已设为 `public`
+- `npm pack --dry-run` 可通过
+
+## 安装模式
+
+### 全局模式
+
+```bash
+npx ys-team install-skills
+```
+
+默认写入：
+
+```text
+~/.agents/skills
+```
+
+### 项目模式
+
+```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`
+
+## 真实发布仍需的条件
+
+以下步骤尚未在仓库内自动化：
+
+1. 准备 npm 账号
+2. 执行 `npm login`
+3. 如启用 2FA，按 npm 要求完成验证
+4. 在发布环境中执行：
+
+```bash
+npm publish
+```
+
+## 建议发布前检查
+
+```bash
+node scripts/ys-team.mjs --help
+node scripts/ys-team.mjs install-skills --dry-run
+node scripts/ys-team.mjs init-project --dir /tmp/ys-team-project-check --dry-run
+npm pack --dry-run
+```

package/docs/project/overview.md

@@ -0,0 +1,87 @@
+# ys-team 项目概览
+
+## 项目定位
+
+`ys-team` 是一个面向 AI 团队治理的轻量方法论仓库。
+
+它的目标不是提供重型流程系统，而是提供：
+
+- 一组稳定的治理原则
+- 一组可分发的 skills
+- 一套可在项目内本地化的 baseline 工作流
+- 一种以 Spec 为中心的工作方式
+
+## 当前状态
+
+当前仓库已完成第一版骨架，并进入收口阶段，主要承载：
+
+- `ys-team` 理念入口 skill
+- `examples/baseline/` 默认工作流骨架
+- `ys-team-init` 初始化 skill
+- `ys-team-rebuild` 重建 skill
+- 一组支撑 discussion / spec / work / acceptance 的静默内部 skills
+- 一份供本仓和下游项目共用的 baseline version / reality index 约束
+- 本仓自用的 `.ys_team/` 配置
+- 一组用于收口产品化细节并可继续演进的 specs
+
+## 核心原则
+
+- 现实先于生成。
+- 规格先于执行。
+- 讨论归于收敛。
+- 证据胜于感觉。
+
+## 目标用户
+
+- 想在项目内使用 AI 员工协作的团队
+- 想以低侵入方式给 Python 或 Java 项目接入 spec-first 工作方式的团队
+- 想把项目本地规则和全局方法论分层管理的团队
+
+## 当前边界
+
+当前仓库先不追求完整的技能矩阵和自动化安装器。
+
+当前优先级是：
+
+1. 收口方法论定义
+2. 明确 baseline / init / rebuild 的职责边界
+3. 给 Python / Java 项目提供可解释、可起步的接入方式
+4. 让 init 后的项目能直接进入类似 `ai-gateway` 的默认工作流
+5. 让 ys-team 工作流在用户响应中具备稳定、明显的可见标志
+
+## 工作流可见标志
+
+`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`
+
+如果缺少这些标志，应视为还没有真正进入 ys-team 工作流。
+
+## npm 分发边界
+
+仓库已提供双模式 npm 安装面：
+
+- 全局模式：通过 `install-skills` 安装到 `~/.agents/skills`
+- 项目模式：通过 `init-project` 安装到项目内 `.agents/skills`，并下发 baseline 版 `AGENTS.md` / `CLAUDE.md`
+
+当前 npm 面已经能完成“把 ys-team skills 装到用户级或项目级目录”这一核心动作。
+
+当前仍不把 npm 包定义为完整安装器；目标项目接入仍需要后续执行 `ys-team-init`。
+
+另一个边界是：仓库已具备可发布形态，但真实 npm registry 发布仍依赖发布者自己的 npm 账号和凭证。
+
+## 默认落地模型
+
+当前仓库的落地模型是：
+
+- `ys-team` 提供方法论和公开入口
+- `examples/baseline/` 承载默认工作流骨架
+- `.ys_team/` 作为方法仓自用本地基线，并显式对齐 baseline version
+- `ys-team-init` 把 baseline 按项目现实落到本地
+- 静默内部 skills 支撑 discussion、spec、work、status、submit 等能力
+
+目标不是让用户理解全部 skill，而是让用户在 init 后直接开始工作。

package/docs/project/structure.md

@@ -0,0 +1,22 @@
+# ys-team 仓库结构
+
+- `skills/`
+  - 对外发布的 ys-team skills
+  - 同时包含支撑默认工作流的静默内部 skills
+- `CLAUDE.md` / `AGENTS.md`
+  - 仓库级协作入口
+  - 明确 ys-team 排他工作流与可见标志规则
+- `examples/baseline/`
+  - 默认工作流骨架，作为 `ys-team-init` 的默认来源
+  - 包含会下发到项目的 `AGENTS.md` / `CLAUDE.md` 默认约束
+- `.ys_team/`
+  - 本仓自用的 ys-team 本地工作流基线
+- `docs/project/`
+  - 仓库现状、结构、方法论说明和 module index
+- `docs/specs/`
+  - 本仓后续演进 spec
+- `docs/roadmap/`
+  - 版本或阶段级规划，当前仅保留目录
+- `package.json` / `scripts/`
+  - npm 分发元数据和 CLI 安装入口
+  - 当前提供 `install-skills` 与 `init-project` 两个命令

package/docs/roadmap/active/.gitkeep

@@ -0,0 +1 @@
+

package/docs/roadmap/cancelled/.gitkeep

@@ -0,0 +1 @@
+

package/docs/roadmap/completed/.gitkeep

@@ -0,0 +1 @@
+

package/docs/roadmap/queued/.gitkeep

@@ -0,0 +1 @@
+

package/docs/specs/active/.gitkeep

@@ -0,0 +1 @@
+

package/docs/specs/active/20260407-170500-npm-distribution-modes/control.md

@@ -0,0 +1,121 @@
+---
+Spec-Type: control
+Initiative: 20260407-170500-npm-distribution-modes
+Status: active
+Owner-Session: ys-team
+Write-Scope: []
+Depends-On: []
+Parallel-With: []
+Blocked-By: ""
+Verification: "Manual review of CLI modes, README/docs consistency, and npm dry-run output."
+Integration-Gate: |
+  1. 全局安装默认目录切换到 `~/.agents/skills`。
+  2. npm CLI 同时支持全局安装和项目级安装两种模式。
+  3. 项目级安装不依赖全局 skills，能在项目中直接获得本地 `AGENTS.md` / `CLAUDE.md` 与 `.agents/skills`。
+  4. 发布文档明确区分“已具备可发布形态”和“实际发布到 npm registry 仍需账号凭证”。
+---
+
+# npm 分发模式收口
+
+## Background
+
+当前 npm CLI 已具备最小 skills 安装能力，但默认目录还是 `~/.codex/skills`，且只覆盖全局型安装。
+
+用户现在需要两种分发模式：
+
+- 全局安装：安装到用户级 skills 目录，后续在项目里运行 init
+- 项目级安装：不依赖全局 skills，直接把本地 skills 和协作入口装到项目里
+
+## Goals
+
+- 把全局安装默认目录改为 `~/.agents/skills`
+- 增加项目级安装命令
+- 明确 npm registry 发布边界与所需条件
+
+## Non-goals
+
+- 本次不直接执行真实 `npm publish`
+- 本次不实现远程凭证管理
+- 本次不自动执行项目内的 `ys-team-init`
+
+## Deliverables
+
+- 更新后的 npm CLI
+- README / 项目文档中的双模式安装说明
+- 发布说明或脚本入口
+
+## Acceptance Criteria
+
+- `install-skills` 默认指向 `~/.agents/skills`
+- 存在项目级安装命令，能落地 `.agents/skills` 与项目协作入口文件
+- 文档清楚说明“当前代码已可发布，但真正发布仍需要 npm 账号/token/2FA”
+
+## Collaboration Summary
+
+- Participants:
+  - method-architect
+  - product-evolution-owner
+  - delivery-guard
+- Participant Titles:
+  - 方法论架构师
+  - 产品演进负责人
+  - 交付守门人
+- Discussion Rounds:
+  - 1
+- Escalations:
+  - None
+- Reporter:
+  - method-architect
+- Reporter Title:
+  - 方法论架构师
+- Estimated Cost:
+  - 1
+- Submit Recommendation:
+  - Yes
+
+## Discussion Digest
+
+- 方法论架构师：
+  - 双模式安装应保持边界清晰，不让项目级安装和 init 混成同一件事。
+- 产品演进负责人：
+  - 项目级安装必须能让用户在仓库内立即看到 ys-team 入口，不依赖全局环境。
+- 交付守门人：
+  - 发布能力要区分“代码形态已就绪”和“真实 registry 发布已完成”。
+
+## Delivery Plan
+
+- `work-01`：切换默认全局目录并新增项目级安装命令
+- `work-02`：同步 README / docs / publish 说明
+
+## Verification
+
+- `node scripts/ys-team.mjs --help`
+- `node scripts/ys-team.mjs install-skills --dry-run`
+- `node scripts/ys-team.mjs init-project --dir /tmp/ys-team-project-check --force`
+- `npm pack --dry-run`
+
+## Acceptance Evidence
+
+### 文件清单
+
+- `docs/specs/active/20260407-170500-npm-distribution-modes/control.md`
+
+### 验收要求
+
+- 双模式安装和发布边界都能被人工复核
+
+## Documentation Updates
+
+- `README.md`
+- `docs/project/overview.md`
+- `docs/project/structure.md`
+- `docs/project/module-index.md`
+
+## Risks
+
+- 如果项目级安装写入策略过重，可能覆盖用户已有项目入口文件
+- 如果发布文案不够明确，用户会误以为已经完成 registry 发布
+
+## Rollback Plan
+
+- 回退到只保留全局安装模式，并恢复文档为“可发布但未发布”

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

@@ -0,0 +1,58 @@
+# Progress Evidence
+
+## Implemented
+
+- 默认全局安装目录已切换到 `~/.agents/skills`
+- `install-skills` 支持全局安装
+- `init-project` 支持项目级安装，并写入：
+  - `.agents/skills`
+  - `AGENTS.md`
+  - `CLAUDE.md`
+- README / 项目文档 / 发布说明已同步
+- `package.json` 已设置 `publishConfig.access = public`
+
+## Verification
+
+### `node scripts/ys-team.mjs --help`
+
+- 结果：PASS
+
+### `node scripts/ys-team.mjs install-skills --dry-run`
+
+- 结果：PASS
+- 说明：默认目标目录已显示为 `~/.agents/skills`
+
+### `node scripts/ys-team.mjs init-project --dir /tmp/ys-team-project-check --force`
+
+- 结果：PASS
+- 说明：已写入项目本地 `.agents/skills`、`AGENTS.md`、`CLAUDE.md`
+
+### `npm pack --dry-run`
+
+- 结果：PASS
+- 说明：tarball 已包含双模式 CLI、发布说明和相关文档
+
+### `npm whoami`
+
+- 结果：PASS
+- 说明：当前环境可识别 npm 用户 `ys7399`
+
+### `npm view ys-team version name`
+
+- 结果：PASS
+- 说明：返回 404，说明 `ys-team` 包名当前未被占用
+
+### `npm publish`
+
+- 结果：BLOCKED
+- 说明：registry 返回 `E403`，当前凭证不满足 publish 要求，需要 OTP 或带 `bypass 2fa` 的 granular access token
+
+## Current Conclusion
+
+代码形态已经 ready to publish。
+
+真实发布仍阻塞于：
+
+- publish 级别凭证
+- 可能的 OTP
+- 或重新生成带 `bypass 2fa` 的 granular access token