项目项目脚手架

安全 社区

技能解读

当前原文的自动摘译,尚未人工审校。

何时使用该技能

启动一个新库,您希望它从第一天起就具有 TypeScript + Python 表面,并且通过测试而不是振动来强制执行奇偶校验。将单语言库移植到孪生库(例如,您有 TS 但想要 Python 孪生库)并需要跨语言脚手架 — SPEC.md、奇偶校验装置、examples/{sdk,api}/、根 Makefile —

参考结构

该技能产生的规范布局:请参阅references/reference-structure.md了解逐场清单。

占位符

模板使用这些占位符。在编写之前解析每一项:占位符·含义·示例<slug>·Kebab-case包名称(用于npm + PyPI名称)·my-lib``<snake_pkg>·Python模块目录/导入名称·my_lib``<scope>·可选的npm范围(为平面名称而删除)·@your-org或空

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
安全
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@tomevault-io · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
macOS · Linux · Windows
运行环境要求
Node.js · Python
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
步骤 1 — 解析脚手架参数

接受`<slug> [--scope @your-org] [--ts-only|--py-only|--both] [--dry-run]`形式的`$ARGUMENTS`。如果缺少`<slug>`,请通过`AskUserQuestion`询问。验证它是 kebab-case (`^[a-z][a-z0-9-]*$`);否则拒绝并出现明显错误。从`<slug>` (`s/-/_/g`) 派生出`<snake_pkg>`。

02
第 2 步 — 检查工作目录

在 cwd 上运行 `Glob`。如果目录为空(或仅包含 `.git/`、`LICENSE`、`README.md`),则继续使用新的脚手架。如果`packages/ts/`或`packages/py/`已经存在,请勿覆盖。遍历`references/reference-structure.md`中的布局并报告丢失的文件 - 只写入丢失的文件,保留现有的

03
第 3 步 — 写入根文件

按此顺序,从 `references/templates/`: `root-README.md` → `README.md` `root-SPEC.md` → `SPEC.md`(有意为存根 - 用户填充行为;结构是该技能提供的)`root-LICENSE` → `LICENSE`(如果已经存在则跳过)

04
第 4 步 — 编写每个包的文件

对于 TypeScript(当`--both` 或 `--ts-only` 时):源 · 目标 `packages-ts/package.json` · `packages/ts/package.json` `packages-ts/tsconfig.json` · `packages/ts/tsconfig.json` `packages-ts/Makefile` · `packages/ts/Makefile`

05
第 5 步 — 编写奇偶校验 + 示例脚手架

源 · 目标 `tests-parity/fixtures.json` · `tests/parity/fixtures.json` `examples/README.md` · `examples/README.md` `examples/sdk-README.md` · `examples/sdk/README.md` `examples/api-README.md` · `examples/api/README.md`

06
第 6 步 — 验证脚手架靴

写入后,运行冒烟检查:第一次运行将在奇偶校验测试中失败(固定装置文件是存根),并且可能在冒烟测试中失败(公共表面为空)。这是预料之中的——该技能产生一个结构上完整的存储库,而不是行为上完整的存储库。清楚地报告故障,以便

07
第 7 步 — 报告

发出一个简短的摘要:已解决的占位符(`<slug>`、`<snake_pkg>`、`<scope>`)。写入的文件(计数,按树分组)。文件被跳过,因为它们已经存在。烟雾结果(`make ci-install`退出,`make ci`退出,

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。