findscripter 何时使用
适用：
- 搭建/初始化新项目，需要可复制的快速上手流程。
- 团队反馈"环境难配""脚本太多记不住""构建太慢"等摩擦点。
- 你在日常开发中察觉到重复手动操作、反馈回路过长。
- 目标是把"克隆到能跑起来"压缩到 5 分钟内。
不该用（负边界）：
- 任务是业务功能、算法实现或与开发流程无关。
- 需要其他领域专长（如安全审计、性能压测）且与 DX 无交集。
- 缺少必要输入、权限或成功标准时——先停下来澄清，不要臆断。
核心理念：好的开发者体验在顺畅时是隐形的，出问题时才显眼。目标是把它做到"隐形"。
步骤
- 画像：剖析当前开发者工作流，记录从克隆到运行的每一步。
- 定位：找出痛点与耗时点（手动步骤、慢构建、易出错环节）。
- 调研：针对痛点检索最佳实践与工具。
- 增量改进：小步实施，每次改一处并验证，避免一次性大改。
- 度量与迭代：测量影响，对比改进前后指标，持续迭代。
指令
- 先澄清目标、约束与必需输入，再动手。
- 应用相关最佳实践，并对结果做验证。
- 给出可执行的步骤和对应的验证方法。
- 需要详细示例时，打开
resources/implementation-playbook.md。
四大优化方向：
- 环境搭建：把 onboarding 压到 5 分钟内；提供智能默认值；自动化依赖安装；为失败给出有帮助的错误信息。
- 开发工作流：识别可自动化的重复任务；建立有用的别名与快捷方式；优化构建与测试耗时；改善热重载与反馈回路。
- 工具链增强：配置 IDE 设置与扩展；为常见检查设置 Git 钩子；创建项目专属 CLI 命令；集成有用的开发工具。
- 文档：生成"真的能跑通"的上手指南；提供可交互示例；为自定义命令加内联帮助；维护最新的排错指南。
交付物清单：
.claude/commands/中针对常见任务的命令补充。- 改进后的
package.jsonscripts。 - Git 钩子配置。
- IDE 配置文件。
- Makefile 或任务运行器配置。
- README 改进。
成功指标：
- 从克隆到应用运行的时间。
- 被消除的手动步骤数量。
- 构建/测试执行时间。
- 开发者满意度反馈。
示例
场景：新人反馈"配环境花了一下午"。
- 画像后发现：手动装 3 个依赖、手填 .env、手起 2 个服务。
- 改进：写一条
make setup一键安装并生成默认 .env；用make dev并行起服务；在 README 顶部放"克隆 -> setup -> dev"三步。 - 验证：在干净机器上从克隆到首页可访问 < 5 分钟，手动步骤从 7 步降到 2 步。
场景：每次提交都因格式/lint 被 CI 打回。
- 改进：加 pre-commit Git 钩子在本地跑 format + lint，失败即拦截并打印修复命令。
- 验证：CI 因格式问题失败的比例显著下降，反馈回路从分钟级（CI）变为秒级（本地）。
注意事项
- 本技能产物不能替代环境相关的实测、测试或专家评审。
- 增量推进，每次只改一处并验证，避免大爆炸式重构。
- 缺少必需输入、权限、安全边界或成功标准时，先停下来澄清再继续。
- 优先解决高频、高耗时的痛点，先量化再优化，用指标证明价值。
互见
- 项目初始化与代码库文档：可配合 init 流程沉淀 onboarding 文档。
- 配置 Claude Code 钩子与权限：通过 update-config 把"提交前自动检查"等自动化行为落到 settings.json。
采编自 sickn33/antigravity-awesome-skills（MIT）。