Files
praxis/README.md
T
阿白叔andClaude Opus 4.7 c8ce92a2ed docs: refocus on AI behavior, drop human-only sections
team-guide is for AI to read at task start. Removed sections that
only describe human ceremonies and rewrote rules so AI can act on
them directly.

AGENTS.md:
- Replace §6 Planning cadence (Weekly/Quarterly/anti-Jira rhetoric)
  with §6 Per-task spec — the only planning rule AI actually executes.
- §1 Vibe coding rewritten to be AI-actionable: explicit spec
  requirement, observable stop-conditions (300-line / 5-file
  thresholds), self-verification 6 steps phrased as AI behaviors.
- §2 Claude Code & Codex config compressed: each rule = decision +
  one-line rationale, removed prose around skills/memory/sub-agents.
- §3 Git: drop branch owner-prefix rule, draft-PR rhythm, comment
  etiquette. Keep PR description structure and reviewer 5-step.
  Tag examples use <YYYYMMDD> placeholder so AI doesn't anchor on
  a specific date.
- §Editing rules: drop snark ("No 🚀 Getting started! energy") that
  could be misread; plain "No emoji".
- §Working directory: remove hardcoded "~10 files" count.

README.md:
- Drop "速查" cheatsheet (was for humans, redundant with AGENTS.md).
- Drop hardcoded tag examples (20260520).
- Trim positioning explanation in half.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-21 11:52:53 +08:00

2.0 KiB
Raw Blame History

team-guide

我们小团队的 AI 协作开发约定。给 AI 看的——每个项目里 AI 开干前先读这里。

完整规则在 AGENTS.md(英文)。这份 README 只是入口说明。

这个仓库怎么用

AI 进任何团队项目前的读取顺序:

  1. AGENTS.md —— 团队通用规则
  2. library/README.md —— 按当前任务挑相关条目读
  3. 项目自己的 AGENTS.md —— 只放项目特定的东西

项目自己的 AGENTS.md 不重复 team-guide 里的内容,引用就行。

语言策略

  • 本 README 中文——给人读的入口
  • AGENTS.md / CLAUDE.md / library/ 全英文——给 AI 读
  • commit、PR 标题、分支名、tag 注释全英文——AI 工具和搜索吃英文 metadata 更准

目录

team-guide/
├── README.md      ← 中文入口(你正在看)
├── AGENTS.md      ← 全部团队规则(英文)
├── CLAUDE.md      ← 一行 @AGENTS.md import
└── library/       ← 窄主题专项规范
    ├── README.md       ← catalog
    └── <topic>/SPEC.md

版本管理

本仓库按日期打 tag:YYYYMMDD(同一天多次发布加 -N 后缀)。tag 不可改、不可删、不可 force-push。

具体规则见 AGENTS.md §3 Git workflow。项目仓库自己用各自的 tag 方案(通常 semver vX.Y.Z),写在项目的 AGENTS.md 里。

Library 怎么扩

碰到跨项目的具体话题、塞进 AGENTS.md 会拖肿(比如"PII 处理"、"eval 报告格式"),就在 library/<topic>/ 下写 SPEC.md。

收录标准(同时满足):

  1. 至少踩过两次
  2. 比 AGENTS.md 通用规则窄
  3. 步骤稳定到能写下来

加一条要同时更新 library/README.md 的 catalog 表。

远端

git.simgreek.com/simgreek/team-guide · tags 列表

License

Internal.