{"id":50464553,"url":"https://github.com/runesleo/claude-code-workflow","last_synced_at":"2026-06-01T06:32:47.809Z","repository":{"id":341982835,"uuid":"1171383826","full_name":"runesleo/claude-code-workflow","owner":"runesleo","description":"Battle-tested Claude Code workflow template — memory management, context engineering, and task routing from 3 months of daily usage","archived":false,"fork":false,"pushed_at":"2026-04-22T07:21:10.000Z","size":33,"stargazers_count":556,"open_issues_count":0,"forks_count":66,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-22T09:29:25.082Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/runesleo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"docs/agents.md","dco":null,"cla":null}},"created_at":"2026-03-03T07:02:36.000Z","updated_at":"2026-04-22T07:21:14.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/runesleo/claude-code-workflow","commit_stats":null,"previous_names":["runesleo/claude-code-workflow"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/runesleo/claude-code-workflow","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/runesleo%2Fclaude-code-workflow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/runesleo%2Fclaude-code-workflow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/runesleo%2Fclaude-code-workflow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/runesleo%2Fclaude-code-workflow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/runesleo","download_url":"https://codeload.github.com/runesleo/claude-code-workflow/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/runesleo%2Fclaude-code-workflow/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33763649,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-01T02:00:06.963Z","response_time":115,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-01T06:32:46.870Z","updated_at":"2026-06-01T06:32:47.804Z","avatar_url":"https://github.com/runesleo.png","language":null,"funding_links":[],"categories":["Context and Memory Management"],"sub_categories":[],"readme":"# Claude Code 工作流\n\n[English](README.en.md) | **中文**\n\n从多项目日常使用中提炼的 Claude Code 工作流模板——涵盖记忆管理、上下文工程与任务路由。\n\n**不是教程、不是玩具配置。这是一套能真正上线交付的产线工作流。**\n\n\u003e **v2 新特性**：相对 v1 已迭代约 50 天。新增：PreToolUse Hook 层（在工具调用时强制执行规则，而不仅是会话开头）、复杂任务的计划门禁、强制子 Agent 分派检查清单（基于 30 天路由数据），以及将 10 条 P0 规则改写为事件驱动硬规则。完整说明见 [CHANGELOG.md](./CHANGELOG.md)。\n\n## 为什么需要它\n\nClaude Code 本身很强，但没有结构时，很容易变成「会话一断就忘光」的聪明助手。本模板把它变成**可持续、会自我改进的开发搭档**，能：\n\n- 记住过去的错误并自动应用教训\n- 在长会话中管理上下文、减少漂移\n- 将任务路由到合适档位（Opus / Sonnet / Haiku / Codex / Local）\n- 在宣称完成前强制验证（告别「应该好了吧」）\n- 自动保存进度，关窗也不丢活\n\n## 架构：三层\n\n```\n┌─────────────────────────────────────────────────────────┐\n│  Layer 0: 自动加载规则（始终驻留上下文）                  │\n│  ┌─────────────┐ ┌────────────┐ ┌───────────────┐     │\n│  │ behaviors.md │ │skill-      │ │memory-flush.md│     │\n│  │              │ │triggers.md │ │               │     │\n│  └─────────────┘ └────────────┘ └───────────────┘     │\n├─────────────────────────────────────────────────────────┤\n│  Layer 1: 按需文档（需要时加载）                         │\n│  agents.md · content-safety.md · task-routing.md        │\n│  behaviors-extended.md · scaffolding-checkpoint.md ...  │\n├─────────────────────────────────────────────────────────┤\n│  Layer 2: 热数据（你的工作记忆）                        │\n│  today.md · projects.md · goals.md · active-tasks.json   │\n└─────────────────────────────────────────────────────────┘\n```\n\n**为什么分三层？** 上下文成本很高。全量塞入会浪费 token、拉低质量。本设计：始终加载规则（约 2K token）、仅按需读文档（各约 1–3K）、日常状态常热、随取随用。\n\n## 内容结构\n\n```\nclaude-code-workflow/\n├── CLAUDE.md                     # 入口，Claude 先读\n├── README.md                     # 你在这里\n│\n├── rules/                        # Layer 0：常载\n│   ├── behaviors.md              # 行为规则（排错、提交、路由）\n│   ├── skill-triggers.md         # 自动触发 skill 条件\n│   └── memory-flush.md           # 自动保存（避免丢进度）\n│\n├── docs/                         # Layer 1：按需\n│   ├── agents.md                 # 多模型协作框架\n│   ├── behaviors-extended.md     # 拓展规则\n│   ├── behaviors-reference.md    # 操作细则\n│   ├── content-safety.md         # 防幻觉\n│   ├── scaffolding-checkpoint.md # 自建前检清单\n│   └── task-routing.md           # 模型档位与成本\n│\n├── memory/                       # Layer 2：工作态模板\n│   ├── today.md\n│   ├── projects.md\n│   ├── goals.md\n│   └── active-tasks.json\n│\n├── skills/\n│   ├── session-end/SKILL.md\n│   ├── verification-before-completion/SKILL.md\n│   ├── systematic-debugging/SKILL.md\n│   ├── planning-with-files/SKILL.md\n│   └── experience-evolution/SKILL.md\n│\n├── agents/\n│   ├── pr-reviewer.md\n│   ├── security-reviewer.md\n│   └── performance-analyzer.md\n│\n└── commands/\n    ├── debug.md\n    ├── deploy.md\n    ├── exploration.md\n    └── review.md\n```\n\n## 快速开始\n\n### 1. 复制到 Claude Code 配置\n\n```bash\ngit clone https://github.com/runesleo/claude-code-workflow.git\ncp -r claude-code-workflow/* ~/.claude/\n\n# 或符号链接\nln -sf ~/claude-code-workflow/rules ~/.claude/rules\nln -sf ~/claude-code-workflow/docs ~/.claude/docs\n# …\n```\n\n### 2. 自定义 CLAUDE.md\n\n打开 `~/.claude/CLAUDE.md`，补全：\n\n- **用户信息**、主项目目录、社交\n- **子项目记忆路由**\n- **SSOT 归属表**、各类型信息存放位置\n- **按需加载索引**（可调整 doc 路径）\n\n### 3. 启动会话\n\n```bash\nclaude\n```\n\nClaude 会加载规则并按工作流执行。可尝试：写代码时观察**任务路由**、遇到 bug 时看**系统化排错**、说收工看 **session-end** 自动保存、次日从 `today.md` 接上下文。\n\n## 关键概念\n\n### SSOT（单一事实源）\n\n每条信息有且仅有一个规范位置。`CLAUDE.md` 中的 SSOT 表将信息类型映射到文件，先查再写，避免五处各写一版、全部过期。\n\n### Memory Flush\n\n任务完成、每次提交、退出信号时都会自动落盘。半句话关窗也不丢。告别「我忘了保存上下文」。\n\n### 完成前验证\n\n核心规则：未运行验证命令并读输出，就不得声称完成。消灭头号失败模式：没检查就说「应该可以了」。\n\n### 三档（多档）任务路由\n\n不是每件事都需要 Opus。系统按任务复杂度自动匹配模型档位：Opus（关键逻辑/安全/复杂推理）、Sonnet（日常开发）、Haiku（轻量/子任务）、Codex（交叉验证/二阅）、Local（提交信息/格式化/离线）。\n\n### 周日原则\n\n系统优化放在周日。若平日想调工作流而不交付，Claude 会提醒优先产出。周期可改。\n\n## 定制指南\n\n### 新项目\n\n1. 在 `memory/projects.md` 登记  \n2. 在 `CLAUDE.md` 的「子项目记忆路由」里加路由  \n3. 在仓库根建 `PROJECT_CONTEXT.md`\n\n### 新 skill\n\n在 `skills/your-skill/SKILL.md` 中写 frontmatter 与说明（同英文模板）。\n\n### 新 agent\n\n在 `agents/your-agent.md` 中定义（同英文模板）。\n\n### 调整模型路由\n\n编辑 `rules/behaviors.md` 的「任务路由」与 `docs/task-routing.md` 的档位说明。\n\n## 设计哲学\n\n1. **结构 \u003e 单条神 Prompt**：可维护的目录胜过一次性的聪明话术。  \n2. **记忆 \u003e 智商**：会记错的模型比每轮重开的天才更有用。  \n3. **验证 \u003e 感觉**：跑一遍 `npm test` 比上线坏构建便宜。  \n4. **分层加载 \u003e 平铺配置**：常载规则、按需读文档、热数据当需。  \n5. **自动保存 \u003e 靠人记得**：人总会忘，自动化才可靠。\n\n## 环境要求\n\n- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI（Claude Max 或 API 订阅）  \n- 可选：Codex CLI 做交叉验证  \n- 可选：Ollama 作本地回退\n\n## 致谢与来源\n\n- [Manus](https://manus.im/) 的文件化规划思路  \n- OWASP Top 10 安全审查模式  \n- [x-reader](https://github.com/runesleo/x-reader) 等开源项目实战经验\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=runesleo/claude-code-workflow\u0026type=Date)](https://star-history.com/#runesleo/claude-code-workflow\u0026Date)\n\n## 许可\n\nMIT — 随便用、随便改。\n\n## 关于作者\n\n*Leo ([@runes_leo](https://x.com/runes_leo)) — AI × Crypto 独立构建者。在 [Polymarket](https://polymarket.com/?r=githuball\u0026via=runes-leo\u0026utm_source=github\u0026utm_content=claude-code-workflow) 交易，用 Claude Code 与 Codex 做数据与交易系统。*\n\n[leolabs.me](https://leolabs.me) — 写作 · 社区 · 开源小工具 · 独立产品 · 全平台。\n\n[X 会员](https://x.com/runes_leo/creator-subscriptions/subscribe) — 每周付费内容，或请杯咖啡\n\n*公开学、公开做（Learn in public, Build in public）。*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frunesleo%2Fclaude-code-workflow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frunesleo%2Fclaude-code-workflow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frunesleo%2Fclaude-code-workflow/lists"}