📘 核心团队接入指南

git config --global user.name "你的GitHub用户名"
git config --global user.email "你的GitHub用户名@users.noreply.github.com"
gh auth login   # 让本机能推代码（或配好你的 Git 凭据 / PAT）

# 自动同步团队进度面板（全局规则，对所有项目生效）

每当我在【已把 git 远程 origin 指向团队组织 kefucenterteam 的项目】里完成一段有意义的工作，自动执行（不用我提醒）：
- git add -A
- git commit：提交信息用「简体中文一句话」，具体写清这段做了什么（到功能/模块）。动词写明：修复了/优化了/重构调整了/新增了/解决了……（面板据此自动归类：BUG修复/优化/逻辑修整/功能开发/障碍解决…）。别写"更新代码""改一下"。**尽量说人话、少堆生涩技术缩写**——面板会把它整理给主管看。
- git push 到 origin 当前分支
- 如果卡住：提交信息里同时写清「阻碍」和「所需协助」——阻碍＝在等什么资料/缺什么权限/需要谁配合；所需协助＝具体要拿到什么、或谁在什么时间做什么动作。例：「阻塞：等待财务提供对账API文档；需要：财务本周内给出字段说明」。面板会填进「阻碍/所需协助」两栏并在汇总看板「当前阻碍」列出。
- 如果某个功能模块进度有变化（完成/推进/卡住/新增模块），顺手更新项目根目录的 进度看板.md（没有就建），每行：模块名 | 状态 | 进度% | 一句话说明；状态只用 待开始/进行中/待协助/已完成；可选首行「整体: NN%」。可选「里程碑: 一句话」（你判断专案当前整体进展写一句，如「已上线，进入持续优化」，显示在卡头📌）。**每个模块下方可跟若干「✅ 已完成功能 / ⬜ 未完成功能」子行**，让主管看到该架构下哪些功能好了、哪些还没。push 后面板「专案进度总览」自动刷新；只改这个文件不算每日进度。**模块名/说明/功能项都要白话、面向管理层**：把技术改动翻成「对业务/用户/团队的意义」（接口→系统对接、token→凭证、部署→上线…），少堆技术缩写，但要具体、不编造没有的成效。

【安全红线】只对已配置 origin=kefucenterteam 组织仓库的项目自动 push；含密码/token/凭据的文件夹或工作区，绝不自动 git init / add / push。

【为什么】push 后面板用提交信息自动整理成当日进度，写得越清楚面板越准；同一天多次 push 自动合并成一条。阻碍/完成等判断由面板服务端自动完成。

请帮我设置「自动上传 Git + 同步团队进度面板」，并从现在起长期遵守。

【一次性设置】
1. 确认当前项目是 git 仓库；不是就 git init。
2. 把远程 origin 指向团队组织里我的仓库：
   https://github.com/kefucenterteam/<我的仓库名>.git
   - 仓库名就是进度面板上显示的「专案名」，请起个有意义的名字。
   - 如果组织里还没有这个仓库：
     ① 我已有这个仓库（在我自己账号下）→ 到面板「⚙️设置 → 转移仓库 → ①列出我的仓库 → 勾选这一个 → ②转移所选」，只把这一个转进组织（我名下其他仓库不动）；
     ② 全新项目 → 直接在 kefucenterteam 组织下创建一个同名仓库。
3. 设置我的 git 身份 user.name 为我的 GitHub 用户名。
4. 把【从此以后】这些规则写进项目根目录的 CLAUDE.md，让以后每次会话都自动遵守。

【从此以后——每完成一段有意义的工作，就自动执行，不用我提醒】
- git add -A
- git commit：提交信息用「简体中文一句话」，清楚写明这一段做了什么
  （要具体到功能/模块，别写"更新代码""修改一下"这种空话）
  动词写清楚：修复了/优化了/重构调整了/新增了/解决了……——面板会据此
  自动归类（BUG修复 / 优化 / 逻辑修整 / 功能开发 / 障碍解决 等）。
  尽量说人话、少堆生涩技术缩写（面板会把它整理给主管看）。
- git push 到 origin 当前分支
- 如果卡住了：在提交信息里同时写清「阻碍」和「所需协助」，按这条进度实际需要写——
  阻碍＝在等什么资料 / 缺什么权限 / 需要谁配合，才能继续；
  所需协助＝具体要拿到什么、或需要谁在什么时间做什么动作。
  例如：「阻塞：等待财务提供对账 API 文档；需要：财务本周内给出字段说明」。
  面板会自动据此填进「阻碍 / 所需协助」两栏，并在汇总看板的「当前阻碍」里列出。
- 如果这一段让某个「功能模块」的进度有了变化（完成 / 推进 / 卡住 / 新增模块），
  顺手更新项目根目录的 进度看板.md（没有就新建），每行一个模块：
    模块名 | 状态 | 进度% | 一句话说明
  状态只用四种：待开始 / 进行中 / 待协助 / 已完成；可选首行「整体: NN%」(不写自动取平均)。
  可选「里程碑: 一句话」——你判断专案当前整体进展写一句（如「已上线，进入持续优化」），
  显示在总览卡头的 📌 位置。
  每个模块行下方还可以跟若干功能清单子行，标出该架构里哪些功能好了、哪些还没：
    ✅ 已完成的功能
    ⬜ 未完成 / 待做的功能
  （面板会显示在该模块卡片里，给主管一眼看清这个架构下的功能进度。）
  push 后面板「专案进度总览」(给上级看整体进度)会自动刷新。只改这个文件不算进每日进度。
  **模块名和说明要白话、面向管理层**：把技术改动翻成「对业务 / 用户 / 团队的意义」
  （接口→系统对接、token→凭证、部署→上线、缓存→加速…），少堆技术缩写，
  但要具体、不编造没有的成效或数字。（这是给主管看的，别写技术黑话。）

【为什么要这样】
我 push 之后，团队进度面板会用提交信息自动整理成我今天的工作进度，
所以提交信息写得越清楚，面板上的进度就越准。同一天多次 push 会自动合并成一条。
（阻碍/测试/完成等判断都由面板服务端自动完成，你只要把提交信息写清楚即可。）

我要协助团队里一个【已经在组织 kefucenterteam 里的现有专案】，不新建也不转移仓库，只是本次帮忙并把提交推上去，让面板把我这段进度记到那个专案下、算到我头上。

1. 先确认我要协助的是哪个专案、它对应的组织仓库地址：
   https://github.com/kefucenterteam/<目标仓库名>.git
   （目标仓库名 = 进度面板上那个专案卡里显示的英文仓库名；不确定就问管理员 / 艾拉。）
2. 本地没有这个仓库就 git clone 上面的地址；已有本地副本就把 origin 指到上面的地址。
3. 设置我的 git user.name = 我的 GitHub 用户名（一定要设！面板据此把这次提交归到"我"的花名，不影响原负责人）。
4. 我每做完一段有意义的工作：git add -A → 用简体中文一句话写清这段做了什么（具体到功能/模块）→ git push 到 origin 当前分支。

（面板按"谁提交"自动归属：我用自己账号 push，这段进度就算在这个专案下、记到我头上；原负责人的记录不受影响。同一天多次 push 自动合并成一条。）