eis-its-global-conventions Skill 技能

eis-its-global-conventions 是 Skillstore 上面向多团队协作的项目规范统一技能，为 Claude / Codex / Claude Code 等 AI 代理设计。它把跨仓库、跨团队最容易出现漂移的目录结构、文档约定、配置治理、依赖管理、合并门禁、发布就绪度等环节，沉淀为一套结构化的工作流与提示词库，帮助工程负责人、平台团队、新项目启动者快速建立可审计、可交接、可复用的项目规范体系。

技能覆盖新仓库脚手架、目录与文档治理、配置与密钥管理、依赖与测试要求、版本与发布准备五大场景，让 AI 代理在生成代码、撰写文档、规划变更时自动遵循项目既定规范，从而显著降低团队磨合成本与协作摩擦。

核心能力

目录与文件组织：指导 README、CONTRIBUTING、CHANGELOG、docs/、src/、tests/、scripts/ 等关键目录的放置与维护策略。 分支与提交规范：统一 feature / fix / refactor / docs / test 分支前缀与 conventional commits 消息格式，便于 changelog 自动生成。 PR 与 Review 流程：内置 PR 描述模板、Reviewer checklist、合并门禁（测试 + lint + 类型检查 + 文档同步）建议。 配置与密钥治理：覆盖 .env.example、settings 文件、feature flag、密钥引用规范，避免把真实密钥写入仓库。 依赖与测试要求：定义 requirements.txt / package.json / pyproject.toml 的依赖登记规则与合并前必须通过的测试套件。 发布就绪度审计：发布前自动核对文档、依赖、测试、分支、CHANGELOG、release notes 的完整性与一致性。

安装配置

环境前置：团队已统一使用 Git 托管（GitHub / GitLab / Gitee 任一）与一致的 CI 平台。 一键安装：在终端执行 npx skillstore add eis-its/global-conventions，自动写入项目 Skills 目录。 规范文档挂载：在仓库根目录放置 CONVENTIONS.md，技能会读取该文件作为权威规范来源。 PR 模板配置：在 .github/PULL_REQUEST_TEMPLATE.md 或 .gitlab/merge_request_templates/ 中放置团队统一模板。 CI 集成：在 CI 流水线中加入 lint、test、build、docs 同步四项必过门禁。

使用步骤

梳理仓库结构：用 Prompt"Review this repository structure and suggest changes that match the global-conventions skill"让 AI 评估目录布局、README 完整度、依赖文件等关键节点。 标准化 Git 工作流：调用"Standardize Git Workflow"指令定义分支命名、commit 格式、PR 描述、测试要求、CHANGELOG 更新规则。 配置治理规划：使用"Plan configuration governance"指令规划环境变量、settings、feature flag、密钥处理流程，并指定文档负责人。 发布前审计：调用"Audit release readiness"指令核对文档、依赖、测试、分支、CHANGELOG、release notes 的完整度，按优先级列出缺口。 持续对齐：把生成的 CONVENTIONS.md 与 PR 模板合入主干，要求后续 PR 都引用对应章节，逐步收敛团队行为。

适用场景

新仓库启动：为新项目一次性写好目录结构、README、CONTRIBUTING、CHANGELOG、依赖文件与 PR 模板。 团队流程统一：让多个跨地域、跨时区的子团队遵循同一套分支、提交、PR、测试、CHANGELOG 规范。 配置治理：把 .env.example、settings、feature flag、密钥处理规范写到文档，避免凭经验判断。 合规审计准备：发布前自动核对文档、依赖、测试、签名、license 元数据是否齐全。 新人入职引导：把 CONVENTIONS.md 作为新人必读文档，缩短上手时间。

适用人群

工程总监 / Tech Lead：负责在团队内推行一致工程规范的工程管理者。 平台 / 基础设施团队：为多个业务团队提供工程规范模板的 Platform Engineer。 开源项目维护者：希望让外部贡献者快速遵循项目规范的项目 Maintainer。 DevRel / 文档工程师：负责把工程规范落到 README、CONTRIBUTING、CHANGELOG 的内容负责人。 独立开发者：在多个项目之间复用同一套工程规范，提升长期可维护性。

工作原理

技能以 CONVENTIONS.md 与提示词库为底座，不强制依赖特定 CI 系统或云服务。它把项目治理的标准流程拆解为"目录与文件 → 分支与提交 → PR 与 Review → 配置与密钥 → 依赖与测试 → 发布就绪度"六个环节，每个环节都用对应的 Markdown 模板与 Prompt 引导 AI 代理按既定规范执行。技能本身不执行自动化，但生成的规则可一键落到 PR 模板、CI 配置、CONVENTIONS.md 等载体。整体设计强调"规范可审计 + 文档可交接 + 行为可收敛 + 发布可追溯"四大原则。

官方链接

Skillstore 详情页：https://skillstore.io/skills/eis-its-global-conventions GitHub 仓库：https://github.com/EIS-ITS/vss-cli/tree/main/.claude/skills/global-conventions 一键安装：npx skillstore add eis-its/global-conventions Manifest：https://skillstore.io/api/skills/eis-its-global-conventions/manifest