用途:为每个新项目都要做的结构性决策提供一套有主见的默认答案,减少反复权衡的注意力成本。高风险部分(密钥、.env、secret 类 gitignore、CI 密钥存储)不在此技能内,由 manage-secrets-env 负责。
主要能力:
- 分支策略:默认 GitHub Flow,仅保留长期分支 main,使用短生命周期分支(feature/、fix/、refactor/、chore/、docs/、hotfix/),经 PR 合并后删除。
- 依赖锁定:按仓库类型区分。app/template/starter 对生产依赖精确锁定并提交 lockfile;library 声明 semver 范围、lockfile 仅供测试并维护兼容矩阵;monorepo 按包区分,根 lockfile 提交。建议启用 Dependabot/Renovate,可选 CI 中做 CVE 审计。
- 目录布局:领域优先、类型其次;单目录文件超过约 15 个需再分组;目录名应能预测内容。
- 路径可移植性审计:查找 C:\、/Users/<name>、/home/<name>、字面 IPv4、字符串中的 \、/tmp/<specific> 等硬编码路径。
使用方式:执行前先输出 Assumptions 块,明确项目成熟度、分支策略、锁定策略与扫描范围;遇到 main 与 dev 并存、monorepo 按包约定等情形应停下询问。回答结构性问题时用一段话给出默认答案并附下一步,不倾倒整个技能。
适用场景:新项目脚手架、现有仓库审计、遗留仓库约定梳理;也支持只读扫描模式(sweep=read-only)输出发现报告与红黄绿结论,以及 harsh 语气和通俗解释模式。
限制:该技能是建议性的,不自动改动现有布局;不触碰 .env、.gitignore 或任何密钥类文件;不擅自更改操作者未询问的约定;提出约定变更前需先查明原有约定的来源。具体模板与完整规则见其 references 与 templates 目录。