From helloagents
Initializes HelloAGENTS project: creates .helloagents/ dir, AI symlinks (Claude/Gemini/Codex), rule files (AGENTS.md/CLAUDE.md/GEMINI.md), .gitignore entries, and knowledge base (context.md/guidelines.md/DESIGN.md/modules/) for code projects. Invoke via ~init.
npx claudepluginhub hellowind777/helloagents --plugin helloagentsThis skill uses the workspace's default tool permissions.
Trigger: ~init
Initializes or syncs .helloagents/ project knowledge base by analyzing code to generate context.md, guidelines.md, verify.yaml, CHANGELOG.md, DESIGN.md, and modules/ docs. Explicit ~wiki invocation only.
Initializes Claude Code for new projects: runs skeleton script for directories/boilerplate, interactively generates AGENTS.md sections via user prompts, optional research profile. Triggered by 'init project'.
Scaffolds .agents/ folder structure for AI-first development, including session tracking, task management, coding standards, ADRs, security checklists, and configs for .claude, .codex, .cursor. Use when starting AI-assisted projects.
Share bugs, ideas, or general feedback.
Trigger: ~init
~init 是用户显式命令,创建完整知识库,不受 kb_create_mode 限制。
执行 ~init 时,.helloagents/ 目录结构、模板格式和状态文件规则按当前已加载的 HelloAGENTS 规则执行;本命令额外负责项目级规则文件和各宿主项目级 HelloAGENTS 包根链接。
.helloagents/ 在本 skill 中统一按项目级存储路径理解:项目本地 .helloagents/ 继续承担激活目录;状态文件只使用 state_path;若 project_store_mode=repo-shared,知识库、DESIGN.md 与方案包按当前上下文中已注入的项目知识/方案目录写入。
.helloagents/ 目录 + state_path(按 templates/STATE.md 格式,初始“主线目标”写当前初始化任务,初始状态为空闲).claude/skills/helloagents symlink → {插件根目录}/.gemini/skills/helloagents symlink → {插件根目录}/.codex/skills/helloagents symlink → {插件根目录}/
这些链接用于项目级规则定位 HelloAGENTS 的 skills/、templates/ 和 scripts/;宿主若支持递归发现 SKILL.md,也可直接识别包内 skills。{插件根目录} 中的全量规则模板,用 <!-- HELLOAGENTS_START --> / <!-- HELLOAGENTS_END --> 标记包裹后写入:
AGENTS.md(项目根目录,Codex 读取)CLAUDE.md(项目根目录,Claude Code 读取).gemini/GEMINI.md(Gemini CLI 读取,需先创建 .gemini/ 目录)
注意:如果文件已存在且包含标记,替换标记内的内容;如果文件已存在但无标记,追加到末尾;如果文件不存在,创建新文件.gitignore(如果对应行不存在):
.helloagents/
.claude/skills/helloagents
.gemini/skills/helloagents
.codex/skills/helloagents
AGENTS.md
CLAUDE.md
.gemini/GEMINI.md
检查项目是否有实际代码文件(非空项目):
知识库创建流程(与原 ~init 一致;逻辑写入 .helloagents/,project_store_mode=repo-shared 时实际落在共享知识目录):
commands:
- npm run lint
- npm run test
重复执行 ~init 是安全的:
state_path 只记录当前初始化任务;后续进入其他任务时必须按新任务重写