shinpr/ai-coding-project-boilerplate
shinpr/ai-coding-project-boilerplate has 240 GitHub stars and 28 forks. GitHot measured 0 stars in 24 hours, +1 in 7 days, and +4 in 15 days. Last checked 2026-11-22 05:46 UTC. Last push 2026-11-13.
可以做什么
- Develop with TypeScript, Biome formatting and linting, and Vitest already configured
- Record project context and quality standards for later sessions and other contributors
- Turn team knowledge into skills Claude can use when the work calls for them
实测星标增长
- 24小时
- 0
- 7天
- +1
- 15天
- +4
- 1个月
- 正在收集历史
各周期内的星标净变化,周期相互重叠,并非每日新增。缺失的测量保持空白。星标代表关注度,不代表软件质量。
关于
Agentic coding TypeScript boilerplate for Claude Code: sub-agent workflows with built-in quality checks and context engineering.
效率工具README.zh-CN.md
原文AI 编程项目模板:Claude Code 入门套件
为 TypeScript 仓库配置基于 Claude Code 的开发环境。create-ai-project 会添加项目级 CLAUDE.md、可直接使用的命令、专用智能体和技能,让 Claude 在开发时遵循仓库中的规则。
这个入门套件既可以用于创建新项目,也可以持续更新项目中的 Claude Code 配置。你无需自行组装提示词和智能体定义,即可获得一套位于仓库内、可由团队进行版本管理、共享和调整的开发环境。
从这套环境开始开发
- 使用已配置好的 TypeScript、Biome 格式化与 lint 检查,以及 Vitest 测试工具开始开发
- 记录项目上下文和质量标准,供后续会话和其他贡献者使用
- 将团队知识整理为技能,在相关工作中供 Claude 参考
快速开始
请先安装 Node.js 26.12.1 或更高版本、pnpm 和 Claude Code。
创建新项目
npx create-ai-project my-project --lang=zh-CN
cd my-project
pnpm install
claude
如果想使用英文或日文工作流,请在创建时指定 --lang=en 或 --lang=ja。
进行第一次变更
启动 Claude Code 后,运行:
/project-inject
/implement 为 API 添加速率限制
首次使用时,运行 /project-inject 记录项目上下文。
/implement 会明确需求并查看现有代码。简单变更可以直接推进,无需创建设计文档。需要设计决策时,它会先创建设计和计划,等待批准后再实现。之后会运行适用的检查,中大型变更还会进行实现评审。
完整的配置和首次运行步骤请参阅快速开始指南。
选择适合的命令
| 你想做什么 | 从这里开始 |
|---|---|
| 从需求确认推进至实现和验证完成 | /implement |
| 完成范围明确的变更 | /task |
| 在实现前设计变更 | /design、/front-design |
| 将已批准的设计转化为可执行计划 | /plan、/front-plan |
| 按已批准的计划推进实现 | /build、/front-build |
| 评审已完成的实现,确认其符合约定的目标和仓库标准 | /review、/front-review |
| 在确定修复方案前调查问题,不修改代码 | /diagnose |
先设计,后实现
/design 为 API 添加速率限制
/plan
/build
设计命令会停下来等待批准。之后可以依据已批准的文档,在新的会话中或由另一位贡献者继续规划和实现。计划会记录每项任务要完成什么、如何验证,因此交接时无需重新梳理之前的对话。
前端开发使用对应的命令:
/front-design 添加用户个人资料仪表盘
/front-plan
/front-build
有关示例和完整命令参考,请参阅使用场景和命令。
工作流模式
默认使用 Normal 模式。想减少独立检查和智能体调用次数时,可以选择 Lite 模式。它会跳过设计文档与代码的核对、设计文档之间的一致性检查,以及单独的安全评审。按计划推进实现时,Normal 模式会在每项任务完成后运行 lint、测试等质量检查。Lite 模式会在实现结束后集中运行这些检查,再进入代码评审。
Claude 仍会检查自己实现的变更,并进行必要的测试评审和代码评审。仍会在相同的环节征求你的批准。小规模变更以及评审后的修正,也照常进行质量检查。
要将 Lite 模式设为项目默认值,请在项目根目录运行:
node scripts/set-workflow-mode.js lite
设置会保存到 CLAUDE.md,后续会话无需在每次请求中指定模式。运行 node scripts/set-workflow-mode.js normal 可恢复 Normal 模式。你在对话中明确指定的模式优先于项目默认值,并在本次会话中持续生效,直到你要求更改。
根据项目调整配置
使用 /project-inject 记录项目目标、约束、质量标准、开发约定和外部资料的位置。这些信息发生变化时,请重新运行该命令。
如果团队中的某项知识或判断标准只适用于特定工作,可以通过 /create-skill 或 /refine-skill 添加或改进相应技能。这些命令也会帮助你确定信息所属位置,并在使用前进行评审。具体示例请参阅技能编辑指南。
更新 Claude Code 配置
在由这个入门套件创建的项目根目录,先查看更新内容,再应用更新:
npx create-ai-project update --dry-run
npx create-ai-project update
claude
更新程序会替换受管理的 Claude Code 规则、命令、智能体和技能。对这些文件所做的本地修改会被覆盖。源代码、现有的 package.json 设置和已保存的工作流模式会保留。
更新前,请提交项目特有的规则和技能修改,包括通过 /project-inject、/create-skill 或 /refine-skill 所做的修改。更新后,检查差异并手动重新应用需要保留的自定义内容。更新步骤的详细说明请参阅快速开始指南。
指南
许可证
探索相关项目
加载中…