ys-team 0.2.0

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 (78) hide show
  1. package/AGENTS.md +64 -0
  2. package/CLAUDE.md +33 -0
  3. package/LICENSE +21 -0
  4. package/README.md +130 -0
  5. package/docs/project/module-index.md +61 -0
  6. package/docs/project/npm-publish.md +57 -0
  7. package/docs/project/overview.md +87 -0
  8. package/docs/project/structure.md +22 -0
  9. package/docs/roadmap/active/.gitkeep +1 -0
  10. package/docs/roadmap/cancelled/.gitkeep +1 -0
  11. package/docs/roadmap/completed/.gitkeep +1 -0
  12. package/docs/roadmap/queued/.gitkeep +1 -0
  13. package/docs/specs/active/.gitkeep +1 -0
  14. package/docs/specs/active/20260407-170500-npm-distribution-modes/control.md +121 -0
  15. package/docs/specs/active/20260407-170500-npm-distribution-modes/evidence/20260407-dual-mode-and-publish-readiness.md +58 -0
  16. package/docs/specs/active/20260407-170500-npm-distribution-modes/work-01-global-and-project-install.md +57 -0
  17. package/docs/specs/active/20260407-170500-npm-distribution-modes/work-02-doc-and-publish-readiness.md +61 -0
  18. package/docs/specs/cancelled/.gitkeep +1 -0
  19. package/docs/specs/completed/.gitkeep +1 -0
  20. package/docs/specs/completed/20260331-110000-ys-team-init-and-productization/control.md +139 -0
  21. package/docs/specs/completed/20260331-110000-ys-team-init-and-productization/evidence/20260407-closeout.md +29 -0
  22. package/docs/specs/completed/20260331-110000-ys-team-init-and-productization/work-01-method-and-skill-surface.md +70 -0
  23. package/docs/specs/completed/20260331-110000-ys-team-init-and-productization/work-02-python-java-onboarding.md +74 -0
  24. package/docs/specs/completed/20260331-110000-ys-team-init-and-productization/work-03-next-skill-surface.md +70 -0
  25. package/docs/specs/completed/20260331-110000-ys-team-init-and-productization/work-04-workflow-visibility-and-distribution.md +88 -0
  26. package/docs/specs/completed/20260407-161500-npm-skill-installer/control.md +117 -0
  27. package/docs/specs/completed/20260407-161500-npm-skill-installer/evidence/20260407-npm-installer-closeout.md +38 -0
  28. package/docs/specs/completed/20260407-161500-npm-skill-installer/work-01-cli-install-skills.md +58 -0
  29. package/docs/specs/completed/20260407-161500-npm-skill-installer/work-02-doc-and-package-surface.md +61 -0
  30. package/examples/baseline/.ys_team/README.md +5 -0
  31. package/examples/baseline/.ys_team/VERSION +1 -0
  32. package/examples/baseline/.ys_team/evolution/requests.md +12 -0
  33. package/examples/baseline/.ys_team/methods.md +54 -0
  34. package/examples/baseline/.ys_team/policy.md +81 -0
  35. package/examples/baseline/.ys_team/roles/external/db-migration-auditor.md +5 -0
  36. package/examples/baseline/.ys_team/roles/external/frontend-accessibility-reviewer.md +5 -0
  37. package/examples/baseline/.ys_team/roles/external/observability-reviewer.md +5 -0
  38. package/examples/baseline/.ys_team/roles/external/security-reviewer.md +5 -0
  39. package/examples/baseline/.ys_team/roles/internal/delivery-guard.md +5 -0
  40. package/examples/baseline/.ys_team/roles/internal/doc-spec-steward.md +5 -0
  41. package/examples/baseline/.ys_team/roles/internal/domain-integrator.md +5 -0
  42. package/examples/baseline/.ys_team/roles/internal/project-architect.md +5 -0
  43. package/examples/baseline/.ys_team/status.md +23 -0
  44. package/examples/baseline/.ys_team/team.md +34 -0
  45. package/examples/baseline/.ys_team/templates/control.md +31 -0
  46. package/examples/baseline/.ys_team/templates/roadmap-version.md +20 -0
  47. package/examples/baseline/.ys_team/templates/work.md +30 -0
  48. package/examples/baseline/.ys_team/toolbox/_candidates.md +7 -0
  49. package/examples/baseline/.ys_team/toolbox/_sources.md +7 -0
  50. package/examples/baseline/AGENTS.md +51 -0
  51. package/examples/baseline/CLAUDE.md +32 -0
  52. package/examples/baseline/README.md +54 -0
  53. package/examples/baseline/docs/project/overview.md +5 -0
  54. package/examples/baseline/docs/roadmap/active/.gitkeep +1 -0
  55. package/examples/baseline/docs/roadmap/cancelled/.gitkeep +1 -0
  56. package/examples/baseline/docs/roadmap/completed/.gitkeep +1 -0
  57. package/examples/baseline/docs/roadmap/queued/.gitkeep +1 -0
  58. package/examples/baseline/docs/specs/active/.gitkeep +1 -0
  59. package/examples/baseline/docs/specs/cancelled/.gitkeep +1 -0
  60. package/examples/baseline/docs/specs/completed/.gitkeep +1 -0
  61. package/examples/baseline/docs/specs/queued/.gitkeep +1 -0
  62. package/package.json +33 -0
  63. package/registry/frontend-react.md +10 -0
  64. package/registry/fullstack.md +10 -0
  65. package/registry/general.md +16 -0
  66. package/registry/java-backend.md +9 -0
  67. package/registry/python-backend.md +9 -0
  68. package/scripts/hooks-template.json +18 -0
  69. package/scripts/ys-team.mjs +284 -0
  70. package/skills/ys-team/SKILL.md +112 -0
  71. package/skills/ys-team-doc-build/SKILL.md +159 -0
  72. package/skills/ys-team-init/SKILL.md +161 -0
  73. package/skills/ys-team-rebuild/SKILL.md +89 -0
  74. package/skills/ys-team-spec-talk/SKILL.md +163 -0
  75. package/skills/ys-team-spec-work/SKILL.md +92 -0
  76. package/skills/ys-team-status/SKILL.md +86 -0
  77. package/skills/ys-team-submit/SKILL.md +54 -0
  78. package/skills/ys-team-talk/SKILL.md +25 -0
@@ -0,0 +1,86 @@
1
+ ---
2
+ name: ys-team-status
3
+ description: "Silent internal status capability. Read the pre-built status snapshot and display it — zero token cost for status queries."
4
+ ---
5
+
6
+ # ys-team-status
7
+
8
+ This is a silent internal skill.
9
+
10
+ Use it to display the live ys-team state of a repository.
11
+
12
+ ## Purpose
13
+
14
+ 读取 `.ys_team/status.md` 并格式化展示团队当前状态。
15
+
16
+ **不调用大模型分析**——状态数据由各工作流环节在关键节点写入,status 只负责读取和展示。
17
+
18
+ ## Behavior
19
+
20
+ 1. 读取 `.ys_team/status.md`
21
+ 2. 如果文件不存在或 `updated` 为空(`—`),提示:"团队状态尚未初始化。首次执行 spec-talk 或 spec-work 后,状态会自动更新。"
22
+ 3. 如果文件存在且有数据,格式化输出:
23
+ - 活跃 Spec 列表
24
+ - 最新判断(最近 5 条)
25
+ - 阻塞项(高亮显示)
26
+ - 待办事项
27
+ 4. 检查 `.ys_team/VERSION` 与 baseline 版本对齐
28
+
29
+ ## Version Notice
30
+
31
+ 如果 `.ys_team/VERSION` 存在且低于 baseline 版本,追加:
32
+
33
+ ```
34
+ ys-team baseline 有更新(当前 X.Y.Z,最新 A.B.C)。运行 /ys-team-rebuild 同步。
35
+ ```
36
+
37
+ ## Status 数据写入方
38
+
39
+ status.md 由以下环节在关键节点写入(不是 status skill 的职责):
40
+
41
+ - `spec-talk`:讨论收敛时(PASS / BLOCKED / REJECT)
42
+ - `spec-work`:执行开始、执行完成时
43
+ - `submit`:验收判断时
44
+ - `rebuild`:团队配置变更后
45
+
46
+ ## Completed Spec Policy
47
+
48
+ 默认不读取 completed / cancelled spec 内容。
49
+
50
+ 输出格式:`Completed: N specs | Cancelled: N specs`
51
+
52
+ Exception: 用户明确要求查看历史时(如"上个月做了什么"),读取 completed specs。
53
+
54
+ ## status.md 格式
55
+
56
+ ```markdown
57
+ # 团队状态
58
+
59
+ updated: [ISO 8601 时间戳]
60
+
61
+ ## 活跃 Spec
62
+
63
+ | Spec | 阶段 | 负责角色 | 状态 |
64
+ |------|------|---------|------|
65
+
66
+ ## 最新判断
67
+
68
+ | 时间 | Spec | 角色 | 决定 | 原因 |
69
+ |------|------|------|------|------|
70
+
71
+ ## 阻塞项
72
+
73
+ ## 待办
74
+ ```
75
+
76
+ ## Visible Marker
77
+
78
+ 状态输出后,必须追加以下可见标志:
79
+
80
+ ```markdown
81
+ ---
82
+ **[状态]** ys-team · status
83
+
84
+ [1 句说明当前仓库处于什么状态。]
85
+ ---
86
+ ```
@@ -0,0 +1,54 @@
1
+ ---
2
+ name: ys-team-submit
3
+ description: "Silent internal delivery-review capability. Recheck acceptance, evidence, documentation sync, and rollback readiness before a repository closes out significant work."
4
+ ---
5
+
6
+ # ys-team-submit
7
+
8
+ This is a silent internal skill.
9
+
10
+ Use it when a repository needs a heavier delivery gate.
11
+
12
+ ## Purpose
13
+
14
+ - review spec acceptance against actual delivery
15
+ - verify evidence completeness
16
+ - verify documentation sync
17
+ - verify rollback and risk notes when required
18
+
19
+ ## Rules
20
+
21
+ - focus on delivery truth, not optimistic summary
22
+ - call out missing evidence or unsynced docs clearly
23
+ - prefer explicit PASS/BLOCKED/REJECT outcomes
24
+
25
+ ## Status 写入
26
+
27
+ 验收判断完成后,必须同步更新 `.ys_team/status.md`:
28
+
29
+ 1. 读取当前 `.ys_team/status.md`
30
+ 2. 更新 `updated` 时间戳
31
+ 3. 更新 `最新判断` 表:追加验收决定(PASS/BLOCKED/REJECT + 原因),保留最近 10 条
32
+ 4. 根据决定更新 `活跃 Spec` 表:
33
+ - PASS:移除该 spec(已交付)
34
+ - BLOCKED:状态改为"验收阻塞",`阻塞项` 追加原因
35
+ - REJECT:状态改为"已驳回",`待办` 追加需要修正的内容
36
+ 5. 写入
37
+
38
+ 此写入是 submit 的固定环节,不可跳过。
39
+
40
+ ## Visible Marker
41
+
42
+ 验收结论输出后,必须以以下块结尾:
43
+
44
+ ```markdown
45
+ ---
46
+ **[验收]** ys-team · submit
47
+
48
+ [1–2 句说明验收结论。]
49
+
50
+ - 决策:PASS / BLOCKED / REJECT
51
+ - 关联 Spec:[spec id]
52
+ - 下一步:[关闭、回修或补证据]
53
+ ---
54
+ ```
@@ -0,0 +1,25 @@
1
+ ---
2
+ name: ys-team-talk
3
+ description: "Silent internal discussion capability for repositories using ys-team. Use local .ys_team guidance to converge requirements, clarify current state, and decide whether spec output is needed."
4
+ ---
5
+
6
+ # ys-team-talk
7
+
8
+ This is a silent internal skill.
9
+
10
+ Use it to run requirement or change discussions inside a repository that already uses `ys-team`.
11
+
12
+ ## Purpose
13
+
14
+ - anchor discussion in repository reality
15
+ - load the minimal relevant local roles
16
+ - converge to a result card and role brief
17
+ - decide whether to stay discussion-only or move into spec
18
+
19
+ ## Rules
20
+
21
+ - read the repository's local `.ys_team/` first
22
+ - prefer the smallest useful role set
23
+ - do not expand discussion without improving convergence
24
+ - stop and request approval before introducing external roles
25
+ - keep user-facing output concise and decisive