Language policy: Chinese for human-facing files (README, docs/, human-fillable templates), English for AI-facing files (CLAUDE.md, AGENTS.md, AI templates). Commits / PRs / branches / tags stay English. - Translate docs/01-06 to Chinese - Translate README.md, PR / handoff / project README templates to Chinese - Drop README.en.md (redundant once language policy is explicit) - Rewrite CLAUDE.md and CLAUDE.md.template under the new policy - Add AGENTS.md (root) and templates/AGENTS.md.template for Codex - Add docs/07-codex.md covering Codex usage and AGENTS.md / CLAUDE.md sync rules Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
3.5 KiB
3.5 KiB
04 — Skill 与规划
我们怎么管 skill 目录、小团队怎么排活。
Skill 目录
"Skill"是 Claude Code 能调用的、命名好的可复用流程。我们维护三份:
- 个人(
~/.claude/skills/)—— 私人,每人自己管。 - 团队(
<repo>/.claude/skills/)—— 提交进仓库,跟项目共享。 - 打包 / 插件 —— 从 marketplace 装。
什么时候做 skill
工作流提升成 skill 要同时满足三条:
- 你已经用同样的方式做过三次。
- 步骤稳定到能写下来。
- 别人按你写的也会做出同样的东西。
只满足两条——留在你的提示词笔记里。
Skill 设计规则
- 一个 skill 一件事。要分支判断"用户想干什么"——拆成两个。
- 用动词短语命名:
review-pr、cut-release、rebuild-fixtures。 不要pr-helper。 - Description(模型看的那行字)说什么时候触发,不是 skill 干啥。 触发由模型判断。
SKILL.md200 行以内。长 skill 拆成阶段。- 例子比说明强。给一个跑通的 run。
Skill review
新 skill 当 PR 看:读、在真实任务上跑一次、merge。一个月没人用的
skill 归档(移到 .claude/skills/_archive/)。
当前活跃 skill(团队)
边走边维护。每条一行说明 + 路径。
# 推荐安装的(marketplace 或拷贝):
# anthropic-skills:consolidate-memory — 周期性 memory 整理
# simplify — review 改动找复用 / 质量问题
# fewer-permission-prompts — 从 transcript 提议 allowlist
# review — review pull request
# security-review — 对 pending 改动做安全 pass
# 团队 skill(本仓库):
# (还没有 —— 提升成 skill 后加进来)
规划节奏
我们 1–3 人。流程能保持对齐就够轻。当下做法:
每周
- 一次异步书面同步(周一上午)。每人发:
- 上周交付了什么(每条一行)。
- 这周准备捡什么(每条一行)。
- 哪儿卡住或不清楚(唯一值得仔细读的部分)。
- 周中 30 分钟实时会。议题来自上面那条"卡住或不清楚"。
每个任务
要超过半天的活,开工前:
- 写 5 行 spec:目标 / 为什么 / 完成标准 / 范围外 / 风险。
- 在 PR description 里贴上(draft PR 也行),写代码前。
- AI 要替你打字的话,这段 spec 就是提示词——直接喂进去。
收尾:
- PR description 更新到跟实际交付一致。
- 学到的、未来你想看到的,进 Claude memory(feedback / project 类型) —— 见 docs/02-claude-code.md。
每季度
留半天:
- 重读本仓库。过期的开 PR 改。
- 重审 skill 目录。不用的归档。
- 跑
consolidate-memory整理个人 memory 文件。
项目结构
工作区下开新项目:
- 复制
templates/README.md.template和templates/CLAUDE.md.template。 - 立刻
git init,哪怕项目是一次性的。一次性项目活得比你想的久。 - 第一个 commit 只放脚手架,没有真实代码。让
git log后续好读。 - 把项目加进工作区 README(有了之后),让别人能发现。
规划不是
- 不是 Jira ticket。两个人不需要看板。
- 不是 Gantt 图。需要 Gantt 说明在做错的东西。
- 不是状态秀。周一帖是为了发现卡点,不是证明你干了活。