ys-team 0.2.0

package/docs/specs/active/20260407-170500-npm-distribution-modes/work-01-global-and-project-install.md

@@ -0,0 +1,57 @@
+---
+Spec-Type: work
+Initiative: 20260407-170500-npm-distribution-modes
+Status: completed
+Owner-Session: ys-team
+Write-Scope:
+  - scripts/
+  - package.json
+Depends-On: []
+Parallel-With: []
+Blocked-By: ""
+Verification: "`node scripts/ys-team.mjs install-skills --dry-run` and `node scripts/ys-team.mjs init-project --dir /tmp/ys-team-project-check --force`."
+Integration-Gate: ""
+---
+
+# Work 01 全局与项目级安装模式
+
+## Background
+
+当前 CLI 只有一种技能安装模式，且默认目录不符合新的要求。
+
+## Goals
+
+- 默认全局目录切到 `~/.agents/skills`
+- 新增项目级安装命令
+- 项目级安装落地本地 `AGENTS.md` / `CLAUDE.md`
+
+## Deliverables
+
+- 更新后的 CLI 命令集
+- 项目级安装文件复制逻辑
+
+## Acceptance Criteria
+
+- 全局默认目录为 `~/.agents/skills`
+- `init-project` 能安装本地 `.agents/skills`
+- `init-project` 不带 `--force` 时不覆盖已有项目入口文件
+
+## Verification
+
+- 运行 help、global dry-run、project install
+
+## Acceptance Evidence
+
+- `docs/specs/active/20260407-170500-npm-distribution-modes/work-01-global-and-project-install.md`
+
+## Documentation Updates
+
+- `README.md`
+
+## Risks
+
+- 项目级安装与真实 init 的边界可能被误解
+
+## Rollback Plan
+
+- 回退到仅支持项目级 skills 复制，不写入入口文件

package/docs/specs/active/20260407-170500-npm-distribution-modes/work-02-doc-and-publish-readiness.md

@@ -0,0 +1,61 @@
+---
+Spec-Type: work
+Initiative: 20260407-170500-npm-distribution-modes
+Status: completed
+Owner-Session: ys-team
+Write-Scope:
+  - README.md
+  - docs/project/
+  - package.json
+Depends-On: []
+Parallel-With: []
+Blocked-By: ""
+Verification: "Manual review plus `npm pack --dry-run`."
+Integration-Gate: ""
+---
+
+# Work 02 文档与发布就绪面同步
+
+## Background
+
+双模式安装落地后，README 与项目文档必须同步，否则用户会误解 npm 的实际边界。
+
+## Goals
+
+- 明确全局/项目级两种使用方式
+- 明确 npm registry 发布的前置条件
+- 保持 package 形态可发布
+
+## Deliverables
+
+- 更新后的 README 与项目文档
+- 发布说明
+
+## Acceptance Criteria
+
+- README 能区分两种安装方式
+- 文档明确“真实发布仍需 npm 凭证”
+
+## Verification
+
+- README/docs 人工检查
+- `npm pack --dry-run`
+
+## Acceptance Evidence
+
+- `docs/specs/active/20260407-170500-npm-distribution-modes/work-02-doc-and-publish-readiness.md`
+
+## Documentation Updates
+
+- `README.md`
+- `docs/project/overview.md`
+- `docs/project/structure.md`
+- `docs/project/module-index.md`
+
+## Risks
+
+- 若发布说明不足，交付会停留在“代码可发布但流程不可执行”
+
+## Rollback Plan
+
+- 回退到只保留 CLI 使用说明

package/docs/specs/cancelled/.gitkeep

@@ -0,0 +1 @@
+

package/docs/specs/completed/.gitkeep

@@ -0,0 +1 @@
+

package/docs/specs/completed/20260331-110000-ys-team-init-and-productization/control.md

@@ -0,0 +1,139 @@
+---
+Spec-Type: control
+Initiative: 20260331-110000-ys-team-init-and-productization
+Status: completed
+Owner-Session: ys-team
+Write-Scope: []
+Depends-On: []
+Parallel-With: []
+Blocked-By: ""
+Verification: "Manual review of README, skills, and local ys-team baseline consistency."
+Integration-Gate: |
+  1. `ys-team` 的对外心智收敛为 ys-team + baseline + init/rebuild。
+  2. Python / Java 项目接入方式可被 README 清晰说明。
+  3. 本仓已具备自己的 ys-team 工作流基线和 `examples/baseline/` 默认工作流。
+  4. `init` 后的项目可直接进入类似 `ai-gateway` 的 discussion / spec / work / acceptance 链路。
+  5. 后续演进方向已被 spec 化。
+---
+
+# ys-team 初始化与产品化收口
+
+## Background
+
+当前 `ys-team` 需要同时解决三件事：
+
+- 作为 GitHub 仓库发布可安装的 skills
+- 把对外心智收敛成极少的使用动作
+- 给默认工作流一个稳定、可阅读、可复用的承载位置
+- 让 Python / Java 项目都能低成本开始使用
+
+本次仓库初始化已经完成第一版骨架，但后续产品化方向仍需用 spec 收口。
+
+## Goals
+
+- 固化 `ys-team` 的极简方法论表达
+- 明确 `baseline`、`ys-team-init` 和 `ys-team-rebuild` 的职责边界
+- 为后续 skill 面扩展和 Java 低侵入接入提供执行基线
+
+## Non-goals
+
+- 本次不追求完整自动安装器实现
+- 本次不追求完整 skill 矩阵一次性补齐
+
+## Deliverables
+
+- 一套可发布的第一版仓库骨架
+- 一套 `examples/baseline/` 默认工作流骨架
+- 一组支撑默认工作流的静默内部 skills
+- 一份定义后续演进方向的 queued spec
+
+## Acceptance Criteria
+
+- 仓库中已有 README、skills、`.ys_team/`、`docs/specs/`
+- 仓库中已有 `examples/baseline/`
+- `README.md` 已说明 Python / Java 项目如何开始使用
+- `skills/` 中已具备支撑默认链路的静默内部 skills
+- 后续改造项被拆成可执行 work
+
+## Collaboration Summary
+
+- Participants:
+  - method-architect
+  - init-onboarding-steward
+  - delivery-guard
+- Participant Titles:
+  - 方法论架构师
+  - 初始化与接入负责人
+  - 交付与验收守门人
+- Discussion Rounds:
+  - 1
+- Escalations:
+  - None
+- Reporter:
+  - method-architect
+- Reporter Title:
+  - 方法论架构师
+- Estimated Cost:
+  - 1
+- Submit Recommendation:
+  - No
+
+## Discussion Digest
+
+- 方法论架构师（method-architect）:
+  - 对外方法论应收敛成极少原则和极少动作，避免把内部 skill 结构暴露为用户心智。
+- 初始化与接入负责人（init-onboarding-steward）:
+  - 用户侧应只理解“装 skills、init 项目、必要时 rebuild”，并确保默认工作流由 baseline 承载，Java 项目能低侵入起步。
+- 交付与验收守门人（delivery-guard）:
+  - 仓库本身必须具备自己的 ys-team 工作流与 spec，后续改造项需要有可跟踪依据。
+
+## Role Brief
+
+- 方法论架构师:
+  - 先固定原则，再扩展 skill 面。
+  - 避免把 ys-team 做成重流程产品。
+- 初始化与接入负责人:
+  - 接入动作必须足够少，文案必须足够短。
+  - Java 项目要能在不改业务代码的前提下起步。
+- 交付与验收守门人:
+  - 当前仓库骨架已落地，但后续产品化仍需 spec 管理。
+  - README、skills 与项目文档要持续保持一致。
+
+## Delivery Plan
+
+- `work-01`：收口公共方法论与 skill 文案
+- `work-02`：完善 baseline 与 Python / Java 项目接入方式
+- `work-03`：补齐静默内部 skill 面与自动理解方向
+
+## Verification
+
+- 人工检查 `README.md`、`skills/*/SKILL.md`、`.ys_team/`、`docs/project/` 是否一致
+- 人工检查 `examples/baseline/` 是否与 README 和 init 职责一致
+
+## Acceptance Evidence
+
+### 文件清单
+
+- `docs/specs/active/20260331-110000-ys-team-init-and-productization/control.md`
+
+### 验收要求
+
+- 当前仓库骨架可被人工审阅并理解
+
+## Documentation Updates
+
+- `README.md`
+- `docs/project/overview.md`
+- `docs/project/structure.md`
+
+## Risks
+
+- 如果静默内部 skills 与 baseline 演化脱节，init 后体验仍可能低于预期
+
+## Rollback Plan
+
+- 若方法论表述出现明显偏差，回到当前 control spec 重新拆分后续 work
+
+## Open Questions
+
+- 静默内部 skills 长期是否全部留在 `skills/` 根目录，还是需要单独分组

package/docs/specs/completed/20260331-110000-ys-team-init-and-productization/evidence/20260407-closeout.md

@@ -0,0 +1,29 @@
+# Closeout Evidence
+
+## Scope
+
+本次收口覆盖以下内容：
+
+- `ys-team` 工作流可见标志
+- 仓库级和 baseline 级 `AGENTS.md` / `CLAUDE.md`
+- README 与项目文档同步
+- npm 最小分发面与 CLI 入口
+
+## Verification
+
+### `node scripts/ys-team.mjs --help`
+
+- 结果：PASS
+- 说明：CLI 正常输出当前 npm 包边界、工作流标志和推荐下一步
+
+### `npm pack --dry-run`
+
+- 结果：PASS
+- 说明：tarball 已包含 `AGENTS.md`、`CLAUDE.md`、`skills/`、`examples/baseline/`、`registry/`、`scripts/` 和文档
+
+## Acceptance Conclusion
+
+PASS
+
+- 工作流可见标志已同时进入 skill 规则、仓库协作入口和 baseline 默认骨架
+- npm 分发面已有明确边界，不再只是隐含存在的 `package.json`

package/docs/specs/completed/20260331-110000-ys-team-init-and-productization/work-01-method-and-skill-surface.md

@@ -0,0 +1,70 @@
+---
+Spec-Type: work
+Initiative: 20260331-110000-ys-team-init-and-productization
+Status: completed
+Owner-Session: ys-team
+Write-Scope:
+  - skills/
+  - README.md
+  - docs/project/
+Depends-On: []
+Parallel-With: []
+Blocked-By: ""
+Verification: "Manual review of method wording and public skill boundaries."
+Integration-Gate: ""
+---
+
+# Work 01 方法论与 skill 对外面收口
+
+## Background
+
+仓库需要先给出极简、稳定、可传播的方法论表达，并把公开 skill 面收敛到用户容易理解的层级。
+
+## Goals
+
+- 固化 `The Zen of ys-team`
+- 明确 `ys-team`、`ys-team-init`、`ys-team-rebuild` 的对外职责
+
+## Deliverables
+
+### 主交付物
+
+- 调整后的 skill 文案
+- 与之对应的 README 和项目文档
+
+## Acceptance Criteria
+
+### 主验收目标
+
+- 使用者能在不理解内部实现细节的情况下理解当前公开入口
+
+## Verification
+
+- 人工检查 `skills/*/SKILL.md` 与 `README.md`
+
+## Acceptance Evidence
+
+### 文件清单
+
+- `docs/specs/active/20260331-110000-ys-team-init-and-productization/work-01-method-and-skill-surface.md`
+
+### 本 work 验收要求
+
+- 当前公开 skill 面不再过度暴露内部结构
+
+## Documentation Updates
+
+- `README.md`
+- `docs/project/overview.md`
+
+## Risks
+
+- 如果后续 skill 面增加过快，可能重新把用户心智复杂化
+
+## Rollback Plan
+
+- 若文案导致职责边界混乱，回退到更少的公开概念
+
+## Open Questions
+
+- `ys-team` 对外是否长期只保留三类 skill

package/docs/specs/completed/20260331-110000-ys-team-init-and-productization/work-02-python-java-onboarding.md

@@ -0,0 +1,74 @@
+---
+Spec-Type: work
+Initiative: 20260331-110000-ys-team-init-and-productization
+Status: completed
+Owner-Session: ys-team
+Write-Scope:
+  - README.md
+  - skills/ys-team-init/
+  - .ys_team/
+Depends-On: []
+Parallel-With: []
+Blocked-By: ""
+Verification: "Manual review of Python and Java onboarding guidance."
+Integration-Gate: ""
+---
+
+# Work 02 Python / Java 接入路径收口
+
+## Background
+
+`ys-team` 想被使用，必须让 Python 和 Java 项目都能低成本起步。
+
+## Goals
+
+- 给默认工作流一个稳定承载位置
+- 让 Python 项目看到如何快速开始
+- 让 Java 项目看到如何在低侵入前提下开始使用
+
+## Deliverables
+
+### 主交付物
+
+- README 中的 Python / Java 使用说明
+- `examples/baseline/` 默认工作流骨架
+- `ys-team-init` 中针对语言差异的最小规则
+
+## Acceptance Criteria
+
+### 主验收目标
+
+- Python / Java 团队都能从 README 理解“怎么开始”，并知道默认工作流从哪里来
+
+## Verification
+
+- 人工检查 README 是否只保留极少动作
+- 人工检查 baseline 是否足够简洁且可阅读
+
+## Acceptance Evidence
+
+### 文件清单
+
+- `docs/specs/active/20260331-110000-ys-team-init-and-productization/work-02-python-java-onboarding.md`
+
+### 本 work 验收要求
+
+- 接入说明足够简洁，且语言差异被正确表达
+
+## Documentation Updates
+
+- `README.md`
+- `docs/project/structure.md`
+
+## Risks
+
+- 如果 Java 场景说明过泛，后续实际接入时还需补模板细节
+- 如果 baseline 带入过多项目特定内容，会降低公共可移植性
+
+## Rollback Plan
+
+- 若说明过长或过细，回退到只保留起步动作和原则
+
+## Open Questions
+
+- 未来是否需要在 baseline 之外增加更多 workflow preset

package/docs/specs/completed/20260331-110000-ys-team-init-and-productization/work-03-next-skill-surface.md

@@ -0,0 +1,70 @@
+---
+Spec-Type: work
+Initiative: 20260331-110000-ys-team-init-and-productization
+Status: completed
+Owner-Session: ys-team
+Write-Scope:
+  - skills/
+  - docs/specs/
+Depends-On: []
+Parallel-With: []
+Blocked-By: ""
+Verification: "Manual review of next-stage skill expansion plan."
+Integration-Gate: ""
+---
+
+# Work 03 下一阶段 skill 面与自动理解方向
+
+## Background
+
+当前仓库已有最小骨架，但如果要让 init 后的项目真正进入类似 `ai-gateway` 的默认工作流，还需要补齐支撑 discussion / spec / work / acceptance 的内部能力。
+
+## Goals
+
+- 补齐默认工作流所需的静默内部 skill 面
+- 明确 init 对不同语言和仓库形态的自动理解边界
+
+## Deliverables
+
+### 主交付物
+
+- 一组静默内部 skills
+- init 自动理解能力的边界建议
+
+## Acceptance Criteria
+
+### 主验收目标
+
+- 默认工作流能力补齐后，用户心智仍保持极少
+
+## Verification
+
+- 人工审阅 skill 面是否仍符合 `The Zen of ys-team`
+
+## Acceptance Evidence
+
+### 文件清单
+
+- `docs/specs/active/20260331-110000-ys-team-init-and-productization/work-03-next-skill-surface.md`
+
+### 本 work 验收要求
+
+- 默认工作流所需内部能力已经在仓库中落下
+
+## Documentation Updates
+
+- `docs/specs/active/20260331-110000-ys-team-init-and-productization/control.md`
+- `README.md`
+- `docs/project/overview.md`
+
+## Risks
+
+- 如果内部 skill 边界不清，可能重新把内部实现暴露成用户心智
+
+## Rollback Plan
+
+- 若扩展方向变重，回到“公开极简、内部丰富”的分层原则
+
+## Open Questions
+
+- 是否需要把静默内部 skills 单独归到 `skills/internal/` 一类目录

package/docs/specs/completed/20260331-110000-ys-team-init-and-productization/work-04-workflow-visibility-and-distribution.md

@@ -0,0 +1,88 @@
+---
+Spec-Type: work
+Initiative: 20260331-110000-ys-team-init-and-productization
+Status: completed
+Owner-Session: ys-team
+Write-Scope:
+  - AGENTS.md
+  - CLAUDE.md
+  - examples/baseline/
+  - skills/
+  - README.md
+  - docs/project/
+  - package.json
+  - scripts/
+Depends-On: []
+Parallel-With: []
+Blocked-By: ""
+Verification: "Manual review of workflow markers and `node scripts/ys-team.mjs --help` plus `npm pack --dry-run`."
+Integration-Gate: ""
+---
+
+# Work 04 工作流可见标志与分发面收口
+
+## Background
+
+当前仓库已经有 `ys-team` 排他工作流和响应标记规则，但标记分散在 skill 文档里，对使用者和下游仓库还不够显眼。
+
+同时仓库已有 `package.json`，但 npm 分发面仍停留在“可打包仓库内容”，还没有一个明确、可执行的入口说明当前 npm 能做什么、不能做什么。
+
+## Goals
+
+- 让 `ys-team` 工作流在仓库内和 baseline 下游仓库中都有明确可见标志
+- 让 `AGENTS.md` 和 `CLAUDE.md` 都能把用户引回 `ys-team` 路由
+- 把当前 npm 能力收敛成一个最小但可执行的入口
+
+## Deliverables
+
+### 主交付物
+
+- 明确的 ys-team 可见标志规范
+- 仓库级与 baseline 级 `AGENTS.md` / `CLAUDE.md`
+- README 和项目文档中的 npm 现状说明
+- 一个最小 npm CLI 入口
+
+## Acceptance Criteria
+
+### 主验收目标
+
+- 用户能通过响应中的明显标志判断当前是否在 `ys-team` 工作流内
+- 若没有标志，仓库级和 baseline 级协作文档都能要求助手回到 `ys-team` 路由
+- npm 安装后的入口能清楚说明当前能力边界
+
+## Verification
+
+- 人工检查 `AGENTS.md`、`CLAUDE.md`、`skills/*/SKILL.md` 的标志规则一致
+- 人工检查 baseline 是否继承同样的可见标志约束
+- 运行 `node scripts/ys-team.mjs --help`
+- 运行 `npm pack --dry-run`
+
+## Acceptance Evidence
+
+### 文件清单
+
+- `docs/specs/active/20260331-110000-ys-team-init-and-productization/work-04-workflow-visibility-and-distribution.md`
+
+### 本 work 验收要求
+
+- 工作流标志和 npm 分发面都能被人工审阅并理解
+
+## Documentation Updates
+
+- `README.md`
+- `docs/project/overview.md`
+- `docs/project/structure.md`
+- `docs/project/module-index.md`
+
+## Risks
+
+- 如果标志规则分散在多个文件但没有统一表述，下游仓库仍可能执行出“看起来像普通回答”的假工作流
+- 如果 npm 面过度承诺自动化能力，会让用户误以为当前已具备一键初始化器
+
+## Rollback Plan
+
+- 如果新增 npm 入口造成错误认知，回退到文档说明模式，保留工作流标志规则
+
+## Open Questions
+
+- 后续是否要把 npm CLI 继续扩成真正的 init/rebuild 安装器