Files
praxis/docs/04-skills-and-planning.md
T
阿白叔andClaude Opus 4.7 154f592f3c docs: split language by audience, add Codex / AGENTS.md spec
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>
2026-05-20 09:44:15 +08:00

3.5 KiB
Raw Blame History

04 — Skill 与规划

我们怎么管 skill 目录、小团队怎么排活。

Skill 目录

"Skill"是 Claude Code 能调用的、命名好的可复用流程。我们维护三份:

  • 个人(~/.claude/skills/)—— 私人,每人自己管。
  • 团队(<repo>/.claude/skills/)—— 提交进仓库,跟项目共享。
  • 打包 / 插件 —— 从 marketplace 装。

什么时候做 skill

工作流提升成 skill 要同时满足三条:

  1. 你已经用同样的方式做过三次。
  2. 步骤稳定到能写下来。
  3. 别人按你写的也会做出同样的东西。

只满足两条——留在你的提示词笔记里。

Skill 设计规则

  • 一个 skill 一件事。要分支判断"用户想干什么"——拆成两个。
  • 用动词短语命名:review-pr、cut-release、rebuild-fixtures。 不要 pr-helper。
  • Description(模型看的那行字)说什么时候触发,不是 skill 干啥。 触发由模型判断。
  • SKILL.md 200 行以内。长 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 人。流程能保持对齐就够轻。当下做法:

每周

  • 一次异步书面同步(周一上午)。每人发:
    1. 上周交付了什么(每条一行)。
    2. 这周准备捡什么(每条一行)。
    3. 哪儿卡住或不清楚(唯一值得仔细读的部分)。
  • 周中 30 分钟实时会。议题来自上面那条"卡住或不清楚"。

每个任务

要超过半天的活,开工前:

  1. 写 5 行 spec:目标 / 为什么 / 完成标准 / 范围外 / 风险。
  2. 在 PR description 里贴上(draft PR 也行),写代码前。
  3. AI 要替你打字的话,这段 spec 就是提示词——直接喂进去。

收尾:

  1. PR description 更新到跟实际交付一致。
  2. 学到的、未来你想看到的,进 Claude memory(feedback / project 类型) —— 见 docs/02-claude-code.md。

每季度

留半天:

  • 重读本仓库。过期的开 PR 改。
  • 重审 skill 目录。不用的归档。
  • 跑 consolidate-memory 整理个人 memory 文件。

项目结构

工作区下开新项目:

  1. 复制 templates/README.md.template 和 templates/CLAUDE.md.template。
  2. 立刻 git init,哪怕项目是一次性的。一次性项目活得比你想的久。
  3. 第一个 commit 只放脚手架,没有真实代码。让 git log 后续好读。
  4. 把项目加进工作区 README(有了之后),让别人能发现。

规划不是

  • 不是 Jira ticket。两个人不需要看板。
  • 不是 Gantt 图。需要 Gantt 说明在做错的东西。
  • 不是状态秀。周一帖是为了发现卡点,不是证明你干了活。