Claude Code TypeScript 项目脚手架
为 Claude Code 项目提供可版本管理的开发规则、命令、专用代理和技能。
- Star 数
- ★ 240
- 最近更新
- 1 天前
- License
- MIT
- 主语言
- JavaScript
- FA 评分
- 54/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用Claude Code
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 需要把 Claude Code 规则、项目约定和质量标准随 TypeScript 代码库一起版本管理的团队。
- 不适合
- 不使用 Claude Code 的开发团队
- 需要免配置通用 TypeScript 脚手架的团队
- 维护状态
- 近 30 天有提交最近提交 2026-11-20最新版本 v2.2.8(2026-11-20)
- 源码审查
- 54/100 · 缺口较多
这个 Agent 能做什么,适合哪些场景?
这是一个用于创建 TypeScript 项目的 Claude Code 入门套件,可通过 create-ai-project 命令生成项目级 CLAUDE.md、常用命令、专用代理和技能。新项目预置 Biome 格式化与 lint、Vitest 测试,并可记录项目背景和质量标准,供后续会话及协作者使用。工作流命令覆盖需求澄清、设计、计划、实现、审查和问题诊断;较大的改动会经过适用检查,设计阶段可先等待用户批准。可选 Lite Mode 会减少部分独立检查和代理调用。它作为项目内的 Claude Code 配置运行,需要 Node.js 26.12.1+、pnpm 和 Claude Code。
npx create-ai-project my-project 创建项目及 Claude Code 配置;进入项目安装依赖后启动 claude。在 Claude Code 中,/project-inject 用于写入项目背景,/implement 会澄清请求并检查现有代码,必要时先准备设计和计划供批准,再实施并运行适用检查。/design、/plan、/build 支持分阶段交接,前端工作有对应的 /front-design、/front-plan、/front-build 命令。/review 检查实现,/diagnose 调查问题而不改代码;/create-skill 和 /refine-skill 用于整理任务专属指导。更新器可预览并替换受管理的 Claude Code 规则、命令、代理和技能;项目源代码及现有 package 设置会保留。
- 需要把 Claude Code 规则、项目约定和质量标准随 TypeScript 代码库一起版本管理的团队。
- 希望从功能请求开始,由 Claude Code 澄清需求、在需要时准备设计计划,再完成实现与检查的开发者。
- 需要先设计并批准方案、之后再由自己或另一位协作者继续计划和实现的团队。
- 希望将团队针对特定任务的知识整理成 Claude 可按需使用技能的维护者。
- 希望减少独立检查和代理调用、但保留代码审查与常规质量检查的项目团队。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
npx create-ai-project my-projectnpx create-ai-project update --dry-runnpx create-ai-project update
- 运行环境
- Node.js 26.12.1+
如何安装或部署这个 Agent?
需要 Node.js 26.12.1+、pnpm 和 Claude Code。用创建器初始化项目,然后安装依赖并启动 Claude Code:
npx create-ai-project my-project
cd my-project
pnpm install
claude创建时可通过 --lang=ja 或 --lang=zh-CN 选择日语或简体中文工作流说明。
如何使用这个 Agent?
首次运行时注入项目背景,再提交一项实现请求:
/project-inject
/implement Add rate limiting to the API如需分阶段设计、计划和实现,可使用:
/design Add rate limiting to the API
/plan
/build将工作流默认模式保存为 Lite Mode:
node scripts/set-workflow-mode.js lite恢复 Normal Mode:
node scripts/set-workflow-mode.js normal更新项目中的受管理配置时,先预览再应用:
npx create-ai-project update --dry-run
npx create-ai-project update
claude这个 Agent 有哪些优点和局限?
- 生成项目级
CLAUDE.md、命令、专用代理和技能,可随代码库共享和维护。 - 预置 TypeScript、Biome 和 Vitest,提供格式化、lint 与测试的起点。
- 同时支持端到端
/implement工作流和设计、计划、构建、审查等分阶段命令。 - 提供 Normal 与 Lite 两种工作流模式,Lite 可减少独立检查和代理调用。
- 工作流依赖 Claude Code,未使用该产品的团队无法直接采用其命令和代理配置。
- 要求 Node.js 26.12.1+、pnpm 和 Claude Code,增加了环境准备步骤。
- 更新器会覆盖正在更新的受管理文件;本地定制需要先提交,并在更新后手动恢复所需内容。
- README 未说明使用 Claude Code 的费用,也未给出离线或其他模型平台的支持路径。
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Claude Code TypeScript 项目脚手架 当前 | 54 · 缺口较多 | 命令行工具 | ★ 240 | 1 天前 | JavaScript | Claude Code |
| OpenCode Swarm | 53 · 缺口较多 | Agent 插件 / 技能免费 + 模型费 | ★ 540 | 1 天前 | TypeScript | — |
| GolemBot | 58 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 324 | 21 天前 | TypeScript | Codex · Claude Code |
| cc-skills-golang:Go 语言智能体技能包 | 51 · 缺口较多 | Agent 插件 / 技能免费 + 模型费 | ★ 3.9k | 12 天前 | Go | ChatGPT · Codex · Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
仓库说明了 Claude Code 命令如何组织工作、何时等待批准,以及 Lite 模式会省略哪些检查;前端技能也明确要求将密钥留在服务端并限制日志中的敏感字段,因此这些控制在普通使用中有依据。依赖安全只展示了版本和 CI 固定的 Action,没有依赖审计或漏洞处置证据;外部影响、更新覆盖及回滚说明较薄,更新会覆盖受管理文件,且来源归属虽有作者和仓库字段但发布者身份未验证。
README 描述的设计、计划、实现和检查流程与技能中的文档职责及错误处理规则大体一致。package.json 和 CI 表明有明确的 Node、pnpm 与检查工具要求,但仅有片段,不能证明依赖长期可用;CI 明确暂未启用测试,且给出的材料没有足够的运行时失败信息设计,因此后两项只部分满足。
README 面向 TypeScript/Claude Code 项目,列出从诊断到设计、构建和审查的场景,并提供日英中语言选项及 Normal/Lite 模式。技能描述了各自适用触发点和技术前提;环境要求明确,但目前证据主要针对 TypeScript、React 及 Claude Code,跨其他语言或代理环境的适配未获证明。
材料包含按语言组织的指南、命令示例、安装步骤、稳定命名、版本号和变更日志入口,MIT 许可证文本完整,故许可项给满分。README 说明更新会覆盖管理文件并建议先提交自定义修改,构成有限的限制说明;但未展示完整 FAQ、完整变更日志或明确的维护承诺与更新责任,因此相关项目未给满分。
脚手架把共享规则、专门代理、技能、命令和质量检查组合为可复用工作流,示例展示了从需求到实现或分阶段设计的实际用法,预计能减少项目初始化和交接成本。材料没有量化收益,也未充分讨论多阶段检查、文档和代理调用带来的额外成本,成本效益项只给部分分数。
README 对模式、批准点和更新行为作出具体陈述,package.json、CI 和技能片段提供部分可对照依据;但给出的文件只是样本,且 CI 注释称测试尚未启用,跨来源佐证有限。技能要求把观察与推断区分开,仓库有一定可追溯性,但无法仅凭这些片段确认所有产品声明。
- CI 中的测试步骤仍被注释,材料未提供测试执行证据;不要将声明的质量检查视为已验证结果。
- 更新会覆盖受管理的规则、命令、代理和技能文件;应用更新前应提交自定义内容并审阅 dry-run 与更新差异。
- 依赖安全、运行时失败处理和维护责任在提供的文件片段中证据有限。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
v2.2.8 Release: v2.2.8
发布说明摘录
- Work Plan tasks take their verification method and Verification Focus from any governing source they cite, such as a UI Spec, not only the Design Doc. - Applied across English, Japanese, and Simplified Chinese.在 GitHub 查看 ↗ -
v2.2.7 Release: v2.2.7
发布说明摘录
This patch makes agents find existing code by responsibility, gives implementers ownership of what they build, and routes problems they notice outside their change to review. Changes apply across English, Japanese, and Simplified Chinese. - Existing code is found by responsibility as well as by reference, so code that shares no name with the change can still be reused. A search that finds nothing is not treated as evidence of absence. …在 GitHub 查看 ↗ -
v2.2.6 Release: v2.2.6
发布说明摘录
This patch makes post-implementation review read large changes in full and makes agents load the criteria they judge by. Changes apply across English, Japanese, and Simplified Chinese. - Reviews a Large change with one code-reviewer per unit of Work Plan tasks, at most 3 at a time. Medium changes keep one reviewer. - code-reviewer judges the changed code and tests directly instead of inventorying every acceptance criterion. The acceptanceCriteria output field is removed. …在 GitHub 查看 ↗
常见问题
运行这个脚手架需要付费吗?
它能在 ChatGPT 或其他编码助手中运行吗?
更新器会覆盖我的项目代码吗?
Lite Mode 会跳过代码审查吗?
能否先完成设计,再在另一个会话继续实现?
/design 会在批准前停止;批准的设计和计划文档可供新会话或其他协作者继续使用。Claude Code TypeScript 项目脚手架 开源吗?
Claude Code TypeScript 项目脚手架 安全吗?
Claude Code TypeScript 项目脚手架 还在维护吗?
Claude Code TypeScript 项目脚手架 是谁开发的?
谢谢反馈,我们会据此改进页面。