用途:按 github-template-ai-agents 模式初始化仓库结构,适用于从模板新建项目、补充缺失的基线基础设施、统一仓库约定以及创建技能软链接。
主要能力:创建目录结构(.agents/skills、plans、agents-docs、scripts、src 各子目录、docs 与 tests 子目录);从模板复制脚本(setup-skills.sh、pre-commit-hook.sh、quality_gate.sh、validate-skills.sh);创建基线配置文件,如 package.json(name 为 gist-app、version 0.1.0、private true、type module)与 tsconfig.json(target ES2022、module ESNext、strict 等严格选项,路径别名 @/、@tokens/、@components/、@services/);创建 setup-skills.sh,在 .claude、.gemini、.qwen、.cursor 下创建指向 ../../.agents/skills 的相对软链接;创建 pre-commit-hook.sh,检测全局 core.hooksPath 并调用质量门禁;quality_gate.sh 依次执行 npm run typecheck、npm run lint 与 validate-skills.sh;validate-skills.sh 检查每个技能目录的 SKILL.md 及其 frontmatter 是否以 --- 开头。
使用方式:按步骤执行上述脚本;注意软链接必须为相对路径,预提交钩子需 chmod +x 可执行,质量门禁在首个错误时快速失败,技能 frontmatter 首行必须为 ---。验证命令包括 ls -la .claude/skills、ls -la .gemini/skills、./scripts/validate-skills.sh、./scripts/quality_gate.sh。
限制:资料未提供收费、价格、平台支持范围或实际效果等信息;质量门禁依赖 npm 与相应脚本已定义,否则相关检查可能被跳过。