eliteforge-agent-doctor

Original：🇨🇳 Chinese

Translated

1 scripts

Check if the development environment is configured properly; if not, first confirm the office location (Chongqing/Beijing), identify the current operating system, system tools, package managers, and eliteforge-* skill environment variable declarations, report them categorized as missing_required, missing_conditional, optional_unset, then attempt to automatically install essential commands and complete configurations such as hosts, Git global settings, Git HTTPS, npm/pip private sources, and pipx packages. Use this skill when the user mentions "check environment configuration", "prepare development environment", "missing commands/hosts/private sources/Git configurations/package management tools/skill environment variables". Trigger threshold: Only use this skill when the user explicitly states that the current project complies with the "璀璨工坊规范" (Bright Workshop Specification) or "eliteforge specification".

2installs

Sourcecloudsen/eliteforge-skills

Added on2026-05-20

NPX Install

npx skill4agent add cloudsen/eliteforge-skills eliteforge-agent-doctor

SKILL.md Content (Chinese)

View Translation Comparison →

EliteForge Agent Doctor

Trigger Threshold

Only use this skill when the user explicitly states that the current project complies with the

璀璨工坊规范

(Bright Workshop Specification) or

eliteforge specification

. If the user does not make this project-level declaration, do not enable this skill; handle it according to general capabilities.

Objectives

Do only one thing: Determine whether the current machine can continue to execute relevant development tasks; if not, try to automatically complete the configurations as much as possible based on the current system's existing capabilities.

Minimum Version Requirements

Java/Javac: Major version must be 25 or above.
Maven: Must be 3.9.10 or above.

Must Confirm First

Before writing to hosts, you must ask the user for their office location:

Chongqing Office: Use

references/cq-required-hosts.txt

, script parameter is

--office cq

Beijing Office: Use

references/bj-required-hosts.txt

, script parameter is

--office bj

If the user does not confirm the office location, only diagnosis and non-hosts fixes are allowed; do not guess the hosts configuration.

Workflow

First confirm whether the user works in Chongqing or Beijing.
Run in
```
report
```
mode, only diagnose without writing. A return code of
```
2
```
from
```
report
```
indicates the environment is not ready, not a script exception.

bash

python3 scripts/bootstrap_env.py --mode report --office cq
python3 scripts/bootstrap_env.py --mode report --office bj

If the report shows the environment is incomplete, after confirming with the user whether to automatically fix it, run in
```
apply
```
mode.

bash

python3 scripts/bootstrap_env.py --mode apply --office cq
python3 scripts/bootstrap_env.py --mode apply --office bj

If automatic installation is blocked by system permissions, report the missing items and permission conditions that require user handling. Do not fake a successful installation.
Only install internal CLIs when subsequent tasks actually need to operate internal platforms.

bash

python3 scripts/bootstrap_env.py --mode apply --office cq --install-internal-clis

After fixing, run
```
report
```
again to output the final status.

Content Handled by the Script

Identify system information: Operating system, platform, architecture, Shell, PATH, home directory, hosts file path.

Identify system tools:

git

,

python3

,

node

,

npm

,

npx

,

pipx

,

jq

,

rg

,

mvn

,

pnpm

,

java

,

javac

,

curl

,

wget

,

sudo

, etc.

Identify SDKMAN and package managers: SDKMAN,
```
brew
```
,
```
apt-get
```
,
```
dnf
```
,
```
yum
```
,
```
pacman
```
,
```
zypper
```
,
```
winget
```
,
```
choco
```
.
By default, only scan the
```
## Environment Variables
```
section in the top-level
```
skills/eliteforge-*/SKILL.md
```
files, and identify skill environment variables according to the format
```
`VAR_NAME,SCREAMING_SNAKE_CASE` [optional|required|conditional] desc
```
specified by
```
eliteforge-skill-spec
```
; only report variable names and missing status, do not print variable values.
Attempt to install essential commands:
```
git
```
,
```
python3
```
,
```
node
```
,
```
npm
```
,
```
npx
```
,
```
pipx
```
,
```
jq
```
,
```
rg
```
,
```
pnpm
```
, Java/Javac 25+, Maven 3.9.10+.
When automatically installing Java/Javac and Maven, if SDKMAN is already installed and can be initialized on the current machine, prioritize installation via SDKMAN; if SDKMAN is unavailable or installation fails, fall back to the system package manager.
Install essential Python CLI packages via
```
pipx
```
:
```
pre-commit
```
.
Configure the npm private source in
```
~/.npmrc
```
.
Configure the pip private source in
```
~/.pip/pip.conf
```
.
Check Git global configurations:
- ```
user.name
```
  must be configured and cannot be a placeholder; it is recommended to use the user's personal Chinese name, but Chinese characters are not required as a readiness gate.
- ```
user.email
```
  must be configured and cannot be a placeholder; it is recommended to use a valid corporate email.
- ```
init.defaultBranch=master
```
- ```
color.ui=auto
```
- ```
pager.branch=false
```
- ```
pager.status=false
```
- ```
core.quotePath=false
```
- ```
http.https://git.cisdigital.cn.proxy=
```
  empty value
Rewrite the SSH address of
```
git.cisdigital.cn
```
to HTTPS.
Maintain
```
/etc/hosts
```
according to the confirmed office location.

Security Rules

Do not hardcode, commit to the repository, or directly print passwords, Tokens, or shared credentials.
Private source credentials are subject to the online "Must-Know" documentation; the script only maintains non-sensitive source address configurations, and does not require or read local private source credential environment variables.
Git personal identity configurations must be completed by the user manually executing
```
git config --global user.name "Your Name"
```
and
```
git config --global user.email "Corporate Email"
```
; the script does not write them automatically. The readiness judgment for
```
user.name
```
/
```
user.email
```
is based on "configured and not a placeholder"; non-Chinese names or non-standard emails are only suggested prompts, not blocking items.
When private source authentication information is required, prompt the user to write it to the local configuration according to the online "Must-Know" documentation; do not ask the user to send passwords or Tokens in plain text in the conversation.
If the same domain name in
```
/etc/hosts
```
already points to another IP, do not overwrite it; must report the conflict.
When writing to hosts, only maintain the script-marked blocks; do not clear the user's existing content.
System installation and hosts writing only attempt "automatically completable" operations; when interactive sudo, administrator privileges, account activation, or project authorization are required, report the block.
```
git.cisdigital.cn
```
prioritizes HTTPS; prohibit requiring users to switch to SSH cloning.

Script Parameters

```
--mode report|apply
```
:
```
report
```
only checks;
```
apply
```
writes security fixes and attempts to install missing dependencies.
```
--office cq|bj
```
: Required business parameter, confirmed by the user; use
```
cq
```
for Chongqing,
```
bj
```
for Beijing.
```
--package-manager auto|brew|apt-get|dnf|yum|pacman|zypper|winget|choco
```
: Force specify when automatic detection is inaccurate. This parameter only controls the fallback path of the system package manager; Java/Javac and Maven still prioritize SDKMAN.
```
--home-dir
```
and
```
--hosts-file
```
: Can point to temporary paths for verification without polluting the real machine.
```
--skills-root
```
: Specify the directory where
```
eliteforge-*
```
skills are located; default is inferred as the repository's
```
skills
```
directory based on the script's location.
```
--skip-install
```
: Skip tool installation, but still apply configuration file fixes.
```
--install-internal-clis
```
: Install or upgrade internal Python CLIs via
```
pipx
```
.

Output Rules

Summaries should be concise and actionable, covering at least:

system

,

SDKMAN

,

package manager

,

tools

,

hosts

,

npm/pip mirrors

,

git global config

,

git https rewrite

,

pipx packages

,

skill_env_vars

,

remaining blockers

.

If
```
apply
```
is run, clearly state which files were modified, which installation commands were executed, and which items were blocked by permissions or accounts.

skill_env_vars

must be reported in three categories:

missing_required

,

missing_conditional

,

optional_unset

; only

missing_required

and triggered

missing_conditional

are environment readiness blockers.

If
```
skill_env_vars.missing_required
```
or
```
skill_env_vars.missing_conditional
```
is not empty, must prompt the user to configure the corresponding environment variables; do not ask the user to send passwords or Tokens in plain text in the conversation.
For items that still require manual handling, specify the specific conditions or files, do not copy the reference materials in full.

Reference Materials

```
references/onboarding-checklist.md
```
: Human pre-requisites, private source credentials, security boundaries.
```
references/cq-required-hosts.txt
```
: Chongqing office hosts.
```
references/bj-required-hosts.txt
```
: Beijing office hosts.

eliteforge-agent-doctor

NPX Install

Tags

SKILL.md Content (Chinese)

EliteForge Agent Doctor

Trigger Threshold

Objectives

Minimum Version Requirements

Must Confirm First

Workflow

Content Handled by the Script

Security Rules

Script Parameters

Output Rules

Reference Materials