claude-scaffold：fork-and-fill 的 Claude Code 项目脚手架

claude-scaffold：fork-and-fill 的 Claude Code 项目脚手架

深度判断

值得深挖，因为它不是“又一个 prompt 包”，而是把 .claude/、AGENTS.md、agents、skills、commands、rules、hooks、memory 和 pre-commit gate 打包成可 fork 的项目治理骨架。它对 Harness-Engineering 的启发是：项目级 agent 行为应由 repo-owned files 和强制 gate 共同定义，而不是靠每次会话重新提醒。

机制 / 一阶原理

claude-scaffold 的思路是 fork-and-fill：把一套最小但完整的 Claude Code 项目骨架复制进目标仓库，然后由团队拥有这些普通文件。它区分 P0/P1/P2 规则：P0 立即停止，P1 阻断 PR/commit，P2 作为 review warning；同时用 pre-commit gate 阻止 secret、构建失败、类型错误等可机械判断的问题。

它还包含 SDLC 角色分离 agent、security audit、db migration、knowledge graph、sonar、grill-me、skill-evolve/agent-evolve 等组件。关键机制是把“AI 应该如何工作”变成 repo 内可审查资产和本地可执行检查。

和既有 wiki 的关系

• 与 AGENTS.md-Context-Files 互补：AGENTS.md 是入口，.claude/ 子目录提供更细的能力与规则边界。
• 与 Spec-driven-development / TDD 互补：脚手架把需求澄清、实现、测试、验证放进可调用命令。
• 与 Harness-Engineering 的 deterministic gate 一致：能用 hook 阻止的错误，不应只靠模型自觉。

对 Hermes / llm-wiki 的可执行启发

1. 用户项目如果频繁使用 coding agent，可考虑生成 repo-local .agents/ 或 .hermes/ 脚手架：规则、skills、验证命令和风险等级随 repo 版本化。
2. llm-wiki 的 AI 页面可区分“可直接安装的脚手架”和“仅作为模式参考的脚手架”，避免把带 hook 的工具误当纯文档。
3. 雷达入库时，应记录强制 gate、路径 scoped rules、自我改进机制是否有真实测试，而不是只看 README 口号。

失败模式 / 边界

脚手架可能过拟合 Claude Code，且预设规则如果不适合项目，会制造摩擦或虚假安全感。fork-and-fill 的优点是可拥有，缺点是升级需要人工合并；应先在小仓库试用，再推广到重要项目。

写入记录

• 2026-08-17 09:00 CST：从 GitHub README 深度入库，记录机制、与既有 wiki 概念的关系、Hermes/llm-wiki 可执行启发和失败模式。