project-bootstrap
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseProject Bootstrap
项目引导
Apply Jess's defaults to the repository setup the user requested. A request for
an application or a small prototype does not by itself request the full template.
Preserve established tooling unless migration is part of the request.
按照用户的请求,将Jess的默认配置应用到仓库搭建中。仅请求应用程序或小型原型本身并不意味着需要完整模板。除非请求中包含迁移内容,否则保留已有的工具配置。
Choose the scope
选择范围
Infer the language, artifact type, and requested setup from the task. Distinguish
a minimal runnable project from a repository intended for distribution.
State material infrastructure choices before implementing them. Ask only when
missing information changes a decision the user owns.
- Minimal setup: source layout, dependency manifest, and the commands needed to run and verify the project.
- Repository tooling: formatter, linter, type/build checks, and CI.
- Distribution: release automation and contributor-facing files appropriate to the product.
- Full Jess template: repository tooling, applicable distribution files, and agent-rule and review infrastructure. Use only when the full template or those gates are requested.
从任务中推断语言、制品类型和所需的搭建内容。区分最小可运行项目与用于分发的仓库。在实施前说明重要的基础设施选择。仅当缺失的信息会影响用户自主决策时才询问。
- 最小化搭建:源码布局、依赖清单,以及运行和验证项目所需的命令。
- 仓库工具:格式化工具、代码检查工具(Linter)、类型/构建检查,以及CI。
- 分发配置:发布自动化和面向贡献者的相关文件(根据产品需求)。
- 完整Jess模板:仓库工具、适用的分发文件,以及Agent规则和审查基础设施。仅当明确请求完整模板或相关管控环节时使用。
Tooling defaults
工具默认配置
| Language | Formatter | Linter | Type/build check |
|---|---|---|---|
| Rust | rustfmt | clippy | cargo build / cargo test |
| Go | gofmt / goimports | staticcheck + go vet | go build / go test |
| TypeScript | oxfmt | oxlint | tsc --noEmit |
| Python | ruff format | ruff check | mypy or pyright |
Use one formatter and one lint configuration per language. Start with strict
type checking where supported. Keep boundary parsing possible: do not ban
unknown input types, runtime narrowing, or legitimate React effects globally.
Use code-craft for language-specific guidance when needed.
Define the check suite in one recipe shared by CI and local development.
If hooks are requested, use the same recipe or a scoped fast subset. Do not run
slow full-suite checks on every commit merely to duplicate CI.
| 语言 | 格式化工具 | 代码检查工具 | 类型/构建检查 |
|---|---|---|---|
| Rust | rustfmt | clippy | cargo build / cargo test |
| Go | gofmt / goimports | staticcheck + go vet | go build / go test |
| TypeScript | oxfmt | oxlint | tsc --noEmit |
| Python | ruff format | ruff check | mypy or pyright |
每种语言使用一套格式化工具和一套代码检查配置。在支持的语言中优先启用严格类型检查。确保边界解析可行:不要全局禁用未知输入类型、运行时类型收窄或合法的React副作用。必要时参考语言特定的编码规范。
在一个配置文件中定义检查套件,供CI和本地开发共享。如果请求使用钩子(hooks),则使用同一配置文件或其精简的快速子集。不要为了重复CI的工作而在每次提交时运行耗时的完整检查套件。
Agent infrastructure
Agent基础设施
When agent-rule enforcement or AI review is requested, put each rule at the
lowest layer that can express it faithfully. Prefer compiler and linter checks
over a new agent-rule system. Do not duplicate the same gate across layers.
For an agent-specific rule that needs enforcement, use structural matching where
possible and provide a CI check independent of agent edits. For an AI review
gate, keep reviewer definitions reviewable and protect them through the repo's
ownership rules. Required gates must not silently pass when evaluation fails.
当请求Agent规则强制执行或AI审查时,将每条规则放在能准确表达它的最低层级。优先使用编译器和代码检查工具,而非新建Agent规则系统。不要在多个层级重复设置相同的管控环节。
对于需要强制执行的Agent特定规则,尽可能使用结构匹配,并提供独立于Agent编辑的CI检查。对于AI审查环节,确保审查者定义可被审查,并通过仓库的所有权规则进行保护。必要的管控环节在评估失败时不得静默通过。
Distribution and project files
分发与项目文件
For a CLI intended for binary distribution, prefer tag-triggered releases with
checksummed archives for the supported platforms. Derive the version from the
tag. Include installers only when requested or needed by the distribution plan;
they must verify checksums before installing.
Keep supported platforms and package registries tied to the intended users.
Do not build a platform matrix for an unpublished prototype.
For a repository intended for public distribution, include the license,
contribution instructions, and a private security-reporting path. Add conduct
guidelines, issue templates, dependency updates, and release workflows when the
full template or their specific purpose is requested.
Jess's new-license choices are AGPL-3.0-or-later or Apache-2.0. Ask which to use
when licensing a new project unless the user already chose. With AGPL, Jess's
default for documentation is CC-BY-SA-4.0, recorded in NOTICE. Preserve existing
licenses and third-party notices.
对于打算以二进制形式分发的CLI工具,优先使用标签触发的发布方式,并为支持的平台提供带校验和的归档文件。版本号从标签中派生。仅当请求需要或分发计划要求时才包含安装程序;安装程序必须在安装前验证校验和。
保持支持的平台和包注册中心与目标用户一致。不要为未发布的原型构建平台矩阵。
对于打算公开分发的仓库,需包含许可证、贡献指南,以及私有安全报告渠道。当请求完整模板或特定功能时,添加行为准则、问题模板、依赖更新和发布工作流。
Jess的新许可证选项为AGPL-3.0-or-later或Apache-2.0。除非用户已选择,否则在为新项目选择许可证时需询问。若使用AGPL,Jess的文档默认许可证为CC-BY-SA-4.0,并记录在NOTICE文件中。保留现有许可证和第三方声明。
Verify and report
验证与报告
Run the generated setup and required checks. Confirm CI invokes the maintained
check recipe. Report what was configured and any unverified platform or external
service. Do not publish, create remote repositories, or configure paid services
without authorization for those actions.
运行生成的搭建配置和必要的检查。确认CI调用了维护的检查配置。报告已配置的内容以及任何未验证的平台或外部服务。未经授权,请勿发布、创建远程仓库或配置付费服务。