team-skills 1.0.0

package/.claude/commands/team-pull.md

@@ -0,0 +1,21 @@
+---
+description: 执行 git pull 拉取最新 Skills
+---
+
+# /team-pull — 拉取最新 Skills
+
+## 功能
+
+在本仓库根目录执行 `git pull`，拉取远程最新的 Skills 变更。
+
+## 执行步骤
+
+1. 进入本仓库根目录：`cd "$(git rev-parse --show-toplevel)"`
+2. 检查当前分支状态
+3. 执行 `git pull --rebase`
+4. 报告拉取结果（新增/修改的文件列表）
+
+## 验证
+
+- 确认 `git pull` 执行成功
+- 如有冲突，提示用户手动解决

package/.claude/commands/team-push.md

@@ -0,0 +1,28 @@
+---
+description: 执行 git commit 和 git push 提交 Skills 变更
+argument-hint: [commit-message]
+---
+
+# /team-push — 提交推送 Skills 变更
+
+## 功能
+
+将本仓库的 Skills 变更通过 `git commit` 和 `git push` 提交到远程仓库。
+
+## 参数
+
+- `$ARGUMENTS`：commit message（如不提供则使用默认消息）
+
+## 执行步骤
+
+1. 进入本仓库根目录：`cd "$(git rev-parse --show-toplevel)"`
+2. 检查 `git status`，确认有变更需要提交
+3. 检查是否有敏感文件（`.env`、`credentials`、`secret` 等）被意外包含，如有则排除并添加到 `.gitignore`
+4. 使用 `git add` 逐个添加变更的文件（不使用 `git add -A`，避免意外包含不相关文件）
+5. 使用提供的 commit message 或默认消息执行 `git commit`
+6. 执行 `git push`
+7. 报告提交结果
+
+## 默认 commit message
+
+如未提供参数，使用：`"chore: update team skills [$(date +%Y-%m-%d)]"`

package/.claude/commands/team-setup.md

@@ -0,0 +1,183 @@
+---
+description: 将当前仓库的 skills 和 commands 安装到指定目录（默认 ~/.agents/skills），含 _team-rules/ 共享规则
+argument-hint: [target-dir]
+---
+
+# /team-setup — Skills 安装命令
+
+## 功能
+
+将本仓库的所有内容软链接到目标目录，使 Claude Code 和 Cursor 都能发现并使用，且后续通过 `/team-pull` 即可同步更新。
+
+安装内容：
+
+- `skills/*` → `{target-dir}/`（Agent Skills，含 team-score 评分 Skill 和 using-team-skills meta-skill）
+- `skills/_team-rules/*` → `{target-dir}/_team-rules/`（共享规则文件，被所有 Skill 引用）
+- `.claude/commands/*` → `{target-dir}/{name}/SKILL.md`（Commands 也作为 Skill 安装，Cursor 可发现）
+- `.claude/commands/*` → `~/.claude/commands/`（兼容 Claude Code 斜杠命令）
+- `hooks/hooks.json` → Cursor/Claude Code hooks 目录（可选，用于 session-start 注入）
+
+## 参数
+
+- `$1`（可选）：目标目录，默认为 `~/.agents/skills`
+
+## 执行步骤
+
+### 1. 确定目标目录
+
+```bash
+set -euo pipefail
+TARGET="${1:-$HOME/.agents/skills}"
+REPO_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || echo "$(cd "$(dirname "$0")/../.." && pwd)")"
+mkdir -p "$TARGET"
+echo "目标目录: $TARGET"
+echo "仓库根目录: $REPO_ROOT"
+```
+
+### 2. 安装 Agent Skills
+
+对本仓库 `skills/` 下的每个子目录（排除 `_team-rules` 和 `CLAUDE.md`），在目标目录下创建同名软链接。
+
+```bash
+for dir in "$REPO_ROOT/skills"/*/; do
+  name="$(basename "$dir")"
+  # 跳过 _team-rules（单独处理）
+  [ "$name" = "_team-rules" ] && continue
+  ln -sfn "$dir" "$TARGET/$name"
+  echo "  ✅ Skill: $name → $TARGET/$name"
+done
+```
+
+### 3. 安装共享规则（_team-rules）
+
+```bash
+mkdir -p "$TARGET/_team-rules"
+for f in "$REPO_ROOT/skills/_team-rules"/*; do
+  [ -f "$f" ] || continue
+  ln -sf "$f" "$TARGET/_team-rules/$(basename "$f")"
+  echo "  ✅ Rule: $(basename "$f")"
+done
+```
+
+### 4. 安装 Commands（作为 Skill，供 Cursor 发现）
+
+对本仓库 `.claude/commands/` 下的每个 `.md` 文件，在目标目录下创建 `{name}/SKILL.md` 软链接。
+
+```bash
+for cmd in "$REPO_ROOT/.claude/commands"/*.md; do
+  [ -f "$cmd" ] || continue
+  name="$(basename "$cmd" .md)"
+  # 跳过已作为 Skill 安装的同名目录，避免写入跟随 symlink
+  if [ -L "$TARGET/$name" ]; then
+    echo "  ⚠️  Command Skill $name 跳过：已存在同名 Skill 目录"
+    continue
+  fi
+  mkdir -p "$TARGET/$name"
+  ln -sf "$cmd" "$TARGET/$name/SKILL.md"
+  echo "  ✅ Command Skill: $name → $TARGET/$name/SKILL.md"
+done
+```
+
+### 5. 安装 Commands（兼容 Claude Code 斜杠命令）
+
+```bash
+mkdir -p "$HOME/.claude/commands"
+for cmd in "$REPO_ROOT/.claude/commands"/*.md; do
+  [ -f "$cmd" ] || continue
+  name="$(basename "$cmd")"
+  ln -sf "$cmd" "$HOME/.claude/commands/$name"
+  echo "  ✅ Claude Command: $name → $HOME/.claude/commands/$name"
+done
+```
+
+### 6. 安装 Hooks（可选）
+
+如果目标平台支持 hooks（Cursor / Claude Code），将 `hooks/hooks.json` 和 `hooks/session-start` 安装到对应平台的 hooks 目录。
+
+```bash
+install_hooks() {
+  local hook_dir="$1"
+  local platform="$2"
+  mkdir -p "$hook_dir"
+  if [ -f "$REPO_ROOT/hooks/hooks.json" ]; then
+    ln -sf "$REPO_ROOT/hooks/hooks.json" "$hook_dir/hooks.json"
+    echo "  ✅ ${platform} hooks.json"
+  fi
+  if [ -f "$REPO_ROOT/hooks/session-start" ]; then
+    ln -sf "$REPO_ROOT/hooks/session-start" "$hook_dir/session-start"
+    chmod +x "$hook_dir/session-start" 2>/dev/null || true
+    echo "  ✅ ${platform} session-start"
+  fi
+}
+
+# Cursor hooks
+install_hooks "$HOME/.cursor/hooks" "Cursor"
+# Claude Code hooks
+install_hooks "$HOME/.claude/hooks" "Claude Code"
+```
+
+## 验证
+
+```bash
+echo ""
+echo "=== 验证安装 ==="
+
+# 确认每个 Agent Skill 目录是软链接
+errors=0
+for dir in "$REPO_ROOT/skills"/*/; do
+  name="$(basename "$dir")"
+  [ "$name" = "_team-rules" ] && continue
+  if [ -L "$TARGET/$name" ] && [ -d "$TARGET/$name" ]; then
+    echo "  ✅ $name → $(readlink "$TARGET/$name")"
+  else
+    echo "  ❌ $name 未正确安装"
+    errors=$((errors + 1))
+  fi
+done
+
+# 确认 _team-rules 规则文件
+for f in "$REPO_ROOT/skills/_team-rules"/*; do
+  [ -f "$f" ] || continue
+  name="$(basename "$f")"
+  if [ -L "$TARGET/_team-rules/$name" ]; then
+    echo "  ✅ _team-rules/$name → $(readlink "$TARGET/_team-rules/$name")"
+  else
+    echo "  ❌ _team-rules/$name 未正确安装"
+    errors=$((errors + 1))
+  fi
+done
+
+# 确认 Command Skills
+for cmd in "$REPO_ROOT/.claude/commands"/*.md; do
+  [ -f "$cmd" ] || continue
+  name="$(basename "$cmd" .md)"
+  if [ -L "$TARGET/$name/SKILL.md" ]; then
+    echo "  ✅ Command Skill $name → $(readlink "$TARGET/$name/SKILL.md")"
+  else
+    echo "  ❌ Command Skill $name 未正确安装"
+    errors=$((errors + 1))
+  fi
+done
+
+# 确认 Claude Code 命令
+for cmd in "$REPO_ROOT/.claude/commands"/*.md; do
+  [ -f "$cmd" ] || continue
+  name="$(basename "$cmd")"
+  if [ -L "$HOME/.claude/commands/$name" ]; then
+    echo "  ✅ Claude Command $name → $(readlink "$HOME/.claude/commands/$name")"
+  else
+    echo "  ❌ Claude Command $name 未正确安装"
+    errors=$((errors + 1))
+  fi
+done
+
+if [ "$errors" -eq 0 ]; then
+  echo ""
+  echo "🎉 安装完成！所有组件已正确安装。"
+  echo ""
+  echo "后续可通过 /team-pull 拉取更新。"
+else
+  echo ""
+  echo "⚠️  有 $errors 个组件安装异常，请检查。"
+fi
+```

package/.claude/commands/team-uninstall.md

@@ -0,0 +1,107 @@
+---
+description: 卸载 team-skills 的所有 symlink（Skills、Commands、Hooks）
+argument-hint: [target-dir]
+---
+
+# /team-uninstall — 卸载 Skills
+
+## 功能
+
+移除 `/team-setup` 创建的所有软链接，不影响本仓库源文件。
+
+## 参数
+
+- `$1`（可选）：目标目录，默认为 `~/.agents/skills`
+
+## 执行步骤
+
+### 1. 确定目标目录
+
+```bash
+set -euo pipefail
+TARGET="${1:-$HOME/.agents/skills}"
+REPO_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || echo "$(cd "$(dirname "$0")/../.." && pwd)")"
+echo "卸载来源: $REPO_ROOT"
+echo "目标目录: $TARGET"
+removed=0
+```
+
+### 2. 移除 Agent Skills
+
+```bash
+for dir in "$REPO_ROOT/skills"/*/; do
+  name="$(basename "$dir")"
+  [ "$name" = "_team-rules" ] && continue
+  if [ -L "$TARGET/$name" ]; then
+    rm "$TARGET/$name"
+    echo "  🗑️ Skill: $name"
+    removed=$((removed + 1))
+  fi
+done
+```
+
+### 3. 移除共享规则
+
+```bash
+for f in "$REPO_ROOT/skills/_team-rules"/*; do
+  [ -f "$f" ] || continue
+  name="$(basename "$f")"
+  if [ -L "$TARGET/_team-rules/$name" ]; then
+    rm "$TARGET/_team-rules/$name"
+    echo "  🗑️ Rule: $name"
+    removed=$((removed + 1))
+  fi
+done
+rmdir "$TARGET/_team-rules" 2>/dev/null || true
+```
+
+### 4. 移除 Command Skills
+
+```bash
+for cmd in "$REPO_ROOT/.claude/commands"/*.md; do
+  [ -f "$cmd" ] || continue
+  name="$(basename "$cmd" .md)"
+  if [ -L "$TARGET/$name/SKILL.md" ]; then
+    rm "$TARGET/$name/SKILL.md"
+    rmdir "$TARGET/$name" 2>/dev/null || true
+    echo "  🗑️ Command Skill: $name"
+    removed=$((removed + 1))
+  fi
+done
+```
+
+### 5. 移除 Claude Code 命令
+
+```bash
+for cmd in "$REPO_ROOT/.claude/commands"/*.md; do
+  [ -f "$cmd" ] || continue
+  name="$(basename "$cmd")"
+  if [ -L "$HOME/.claude/commands/$name" ]; then
+    rm "$HOME/.claude/commands/$name"
+    echo "  🗑️ Claude Command: $name"
+    removed=$((removed + 1))
+  fi
+done
+```
+
+### 6. 移除 Hooks
+
+```bash
+for hook_dir in "$HOME/.cursor/hooks" "$HOME/.claude/hooks"; do
+  for f in hooks.json session-start; do
+    if [ -L "$hook_dir/$f" ]; then
+      rm "$hook_dir/$f"
+      echo "  🗑️ Hook: $hook_dir/$f"
+      removed=$((removed + 1))
+    fi
+  done
+done
+```
+
+### 7. 汇报
+
+```bash
+echo ""
+echo "✅ 卸载完成，共移除 $removed 个软链接。"
+echo "本仓库源文件未受影响。"
+```

package/CHANGELOG.md

@@ -0,0 +1,41 @@
+# 变更日志
+
+本文件记录 Team Skills 的所有重要变更。
+
+格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，
+本项目遵循[语义化版本](https://semver.org/lang/zh-CN/spec/v2.0.0.html)。
+
+## [0.2.0] - 2026-06-22
+
+### 新增
+
+- GitHub 社区标准文件：LICENSE、CONTRIBUTING、CODE_OF_CONDUCT、Issue/PR 模板
+- GitHub Actions CI 工作流：Markdown 检查、链接检查、Skill 结构验证
+- `examples/` 目录：快速开始指南和 Skill 使用示例
+- README badges：星标、CI、许可证、工具兼容性、PR 欢迎
+
+### 变更
+
+- 完全重写 README：视觉层次、对比表格、快速开始流程
+- 所有文档统一为中文
+
+### 修复
+
+- 所有 SKILL.md 文件标准化为一致的章节顺序
+- 验证所有 Skill 间的交叉引用完整性
+
+## [0.1.0] - 2026-06-18
+
+### 新增
+
+- 初始发布，包含 12 个核心 Skill
+- Spec-Driven 开发框架，含 SDD 规格标准
+- 有向图回退机制，支持测试/审查反馈自动回退
+- 5 步验证协议，杜绝虚假通过声明
+- 8 条 Constitutional Rules（不可覆盖的硬约束）
+- 4 个人类介入点（H1-H4）
+- 100 分制评分体系：7 项硬门槛 + 5 个维度
+- 三层资产体系：项目级 → 模块级 → 任务级
+- Delta Spec 支持修改类任务
+- Session hook 自动加载 meta-skill
+- 跨平台支持：Claude Code 和 Cursor

package/LICENSE

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