sharewhy skills

这个仓库现在承载 5 个 skill：

• pre-code — 架构先行的开发前引导
• after-code — 完成开发后的复盘与 AI 陷阱审视
• html-use — 通用 HTML 产物整理
• actp-pull — ACTP 团队开工前代码同步
• actp-push — ACTP 团队推送前审查与推送

触发规则

• pre-code 和 after-code 是显式触发 skill
• html-use 是通用展示 skill，用于把内容整理成 HTML 产物
• actp-pull / actp-push 是 ACTP 团队 Git 协作 skill 集合，规范原文: SourceTree团队代码拉取提交与推送规范.pdf

仓库结构

skills/
  pre-code/
    SKILL.md
    preview.html
  after-code/
    SKILL.md
    preview.html
  html-use/
    SKILL.md
    preview.html
  actp-pull/
    SKILL.md
  actp-push/
    SKILL.md

输出约定

• pre-code -> html/precode/
• after-code -> html/aftercode/
• html-use -> html/

如果目录不存在，skill 需要先创建。

HTML 文件命名必须和主题切题，让人一眼看出内容用途，例如：

• payment-status-sync-precheck.html
• payment-status-sync-retro.html
• weekly-review-dashboard.html

ACTP Git 协作 Skills

Skill	触发场景	核心能力
actp-pull	开工 / 开始开发 / 拉取代码	切到个人分支 → fetch → pull → 合并 origin/yra_dev → 输出本次拉取带来的变更摘要
actp-push	提交 / 推送 / push	二次 fetch → 检查本地与远程分支对齐 → 落后则拉取 → 输出本次 push 会改的代码摘要 → 无冲突则 push → 有冲突则诊断冲突原因(双方各自实现什么功能导致冲突) 并引导解决

设计原则

• 不替代 git, 而是在裸 git 命令之上加"业务感知"和"团队协作规范"
• 不自动解决冲突, 把决定权留给用户, 但提供"为什么冲突"和"双方在做什么"的人话解释
• 变更摘要必须输出, 这是区别于普通 git pull/push 的核心价值
• 业务上下文自动读取: 主动读项目根的 AGENTS.md 和 docs/, 让诊断报告带业务背景

安装

方式 1: 整组导入到 CC Switch(推荐)

# Windows PowerShell
$dest = "$env:USERPROFILE\.claude\skills"
New-Item -ItemType Directory -Force -Path $dest | Out-Null

# 克隆仓库后, 软链接或复制 actp-pull/actp-push 到全局 skills 目录
Copy-Item -Recurse .\skills\actp-pull $dest
Copy-Item -Recurse .\skills\actp-push $dest

方式 2: 复制到单个项目(项目级)

# 在你的 ACTP 项目根目录
$dest = ".\.claude\skills"
New-Item -ItemType Directory -Force -Path $dest | Out-Null
Copy-Item -Recurse <sharewhy 路径>\skills\actp-pull $dest
Copy-Item -Recurse <sharewhy 路径>\skills\actp-push $dest

方式 3: CC Switch 应用商店

计划中: 等 CC Switch 商店支持自定义 skill 仓库后, 提交此仓库地址作为分发源。

配合 CC Switch 使用的效果

在 Claude Code / Cursor / Trae / Codex 中:

• 用户输入"开工" → 触发 actp-pull → 自动跑完整流程并给出变更摘要
• 用户输入"推送" → 触发 actp-push → 自动做分支对齐 + 冲突诊断 + 推送
• CC Switch 的供应商切换、MCP 路由等能力与本 skill 互不冲突

团队接入步骤

1. 团队成员安装 CC Switch (官网: ccswitch.io)
2. 把本仓库的 actp-pull 和 actp-push 导入到 ~/.claude/skills/
3. 触发 actp-pull 完成第一次开工前同步
4. 触发 actp-push 完成第一次推送
5. 后续每天按"开工 actp-pull → 干活 → 推送 actp-push"循环

角色对照

角色	本地分支	推送目标	每日额外动作
普通组员	<个人分支>	origin/<个人分支>	通知小组负责人
小组负责人(hepengyue / why_dev / zdy)	<负责人分支>	origin/<负责人分支>	依次合并所有组员, 通知 yra_dev 总负责人
yra_dev 总负责人	yra_dev	origin/yra_dev	一次只合并一个负责人分支, 每合并一个测试一次

Skills

• pre-code
• after-code
• html-use
• actp-pull
• actp-push

Previews

• pre-code preview
• after-code preview
• html-use preview

Existing Files

仓库根目录保留原有网页/媒体文件，不影响 skill 目录结构。