helloagents 1.1.0 → 2.2.7

package/Codex/Skills/EN/skills/helloagents/templates/SKILL.md

@@ -1,451 +0,0 @@
----
-name: templates
-description: Documentation template collection; read when creating Wiki or solution package files; includes all knowledge base templates and solution file templates
----
-
-# Documentation Template Collection
-
-**Template Usage General Instructions:**
-1. Replace `[...]` content with actual content
-2. **Language Specification:** Strictly follow G1 rules. Except for exception list, all content generated in {OUTPUT_LANGUAGE}
-
----
-
-## A1 | Knowledge Base Documentation Templates
-
-### CHANGELOG.md
-
-```markdown
-# Changelog
-
-This file records all important project changes.
-Format based on [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/),
-version numbers follow [Semantic Versioning](https://semver.org/lang/zh-CN/).
-
-## [Unreleased]
-
-## [Version] - YYYY-MM-DD
-
-### Added
-- [New feature description]
-
-### Changed
-- [Change description]
-
-### Fixed
-- [Fix description]
-
-### Removed
-- [Removal description]
-```
-
----
-
-### history/index.md
-
-```markdown
-# Change History Index
-
-This file records index of all completed changes for traceability and query.
-
----
-
-## Index
-
-| Timestamp | Feature Name | Type | Status | Solution Package Path |
-|-----------|--------------|------|--------|----------------------|
-| YYYYMMDDHHMM | [Feature ID] | [Feature/Fix/Refactor] | ✅Completed/[-]Not Executed | [Link] |
-
----
-
-## Archive by Month
-
-### YYYY-MM
-
-- [YYYYMMDDHHMM_feature](YYYY-MM/YYYYMMDDHHMM_feature/) - [One-line feature description]
-```
-
----
-
-### wiki/overview.md
-
-```markdown
-# [Project Name]
-
-> This file contains project-level core information. Detailed module documentation in `modules/` directory.
-
----
-
-## 1. Project Overview
-
-### Goals and Background
-[Brief project goals and background]
-
-### Scope
-- **In scope:** [Core feature boundaries]
-- **Out of scope:** [Explicitly not included]
-
-### Stakeholders
-- **Owner:** [Name/Role]
-
----
-
-## 2. Module Index
-
-| Module Name | Responsibility | Status | Documentation |
-|-------------|----------------|--------|---------------|
-| [Module] | [Core responsibility] | [Stable/In Development] | [Link] |
-
----
-
-## 3. Quick Links
-- [Technical Conventions](../project.md)
-- [Architecture Design](arch.md)
-- [API Manual](api.md)
-- [Data Models](data.md)
-- [Change History](../history/index.md)
-```
-
----
-
-### wiki/arch.md
-
-```markdown
-# Architecture Design
-
-## Overall Architecture
-```mermaid
-flowchart TD
-    A[Component A] --> B[Component B]
-```
-
-## Tech Stack
-- **Backend:** [Language/Framework]
-- **Frontend:** [Framework/Library]
-- **Data:** [Database/Storage]
-
-## Core Flow
-```mermaid
-sequenceDiagram
-    Participant->>System: Action
-```
-
-## Major Architecture Decisions
-Complete ADRs stored in each change's how.md, this section provides index.
-
-| adr_id | title | date | status | affected_modules | details |
-|--------|-------|------|--------|------------------|---------|
-| ADR-[Number] | [Title] | YYYY-MM-DD | ✅Adopted/❌Deprecated | [Module list] | [Link] |
-```
-
----
-
-### project.md
-
-```markdown
-# Project Technical Conventions
-
----
-
-## Tech Stack
-- **Core:** [Language version] / [Framework version]
-
----
-
-## Development Conventions
-- **Code Standards:** [Reference standards or brief description]
-- **Naming Conventions:** [e.g., camelCase/snake_case]
-
----
-
-## Errors and Logging
-- **Strategy:** [Unified error handling approach]
-- **Logging:** [Level and format requirements]
-
----
-
-## Testing and Process
-- **Testing:** [Unit/integration test requirements]
-- **Commit:** [Commit Message specification]
-```
-
----
-
-### wiki/api.md
-
-```markdown
-# API Manual
-
-## Overview
-[Overall API description]
-
-## Authentication Method
-[Authentication mechanism description]
-
----
-
-## API List
-
-### [Module Name]
-
-#### [METHOD] [Path]
-**Description:** [Functionality]
-
-**Request Parameters:**
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| [Param] | [Type] | [Yes/No] | [Description] |
-
-**Response:**
-```json
-{
-  "code": 0,
-  "data": {}
-}
-```
-
-**Error Codes:**
-| Error Code | Description |
-|------------|-------------|
-| [code] | [Description] |
-```
-
----
-
-### wiki/data.md
-
-```markdown
-# Data Models
-
-## Overview
-[Overall data architecture description]
-
----
-
-## Data Tables/Collections
-
-### [Table/Collection Name]
-
-**Description:** [Usage description]
-
-| Field | Type | Constraints | Description |
-|-------|------|-------------|-------------|
-| [Field] | [Type] | [Primary Key/Not Null/Unique, etc.] | [Description] |
-
-**Indexes:**
-- [Index name]: [Field list]
-
-**Relationships:**
-- [Relationship description]
-```
-
----
-
-### wiki/modules/<module>.md
-
-**Status options:** ✅Stable / 🚧In Development / 📝Planning
-
-```markdown
-# [Module Name]
-
-## Purpose
-[One-line module purpose]
-
-## Module Overview
-- **Responsibility:** [Detailed responsibility description]
-- **Status:** [Status icon]
-- **Last Updated:** YYYY-MM-DD
-
-## Specifications
-
-<!-- 🔁 Repeat the following format for each requirement -->
-### Requirement: [Requirement Name]
-**Module:** [Current module name]
-[Requirement description]
-
-#### Scenario: [Scenario Name]
-[Preconditions]
-- [Expected result 1]
-- [Expected result 2]
-<!-- Loop end -->
-
-## API Interfaces
-<!-- Fill if APIs exist -->
-### [METHOD] [Path]
-**Description:** [Functionality]
-**Input:** [Parameters]
-**Output:** [Response]
-
-## Data Models
-<!-- Fill if data tables exist -->
-### [Table/Model Name]
-| Field | Type | Description |
-|-------|------|-------------|
-| [Field] | [Type] | [Description] |
-
-## Dependencies
-- [Dependent module list]
-
-## Change History
-- [YYYYMMDDHHMM_feature](../../history/YYYY-MM/...) - [Change brief]
-```
-
----
-
-## A2 | Solution File Templates
-
-### why.md in plan/ and history/
-
-**Logic Control:** `Product Analysis` section only generated when G8 (Product Design Principles) triggered, otherwise omit.
-
-```markdown
-# Change Proposal: [Feature Name]
-
-## Requirement Background
-[Describe current state, pain points, and change drivers]
-
-<!-- ⚠️ Only generate this section when G8 triggered -->
-## Product Analysis
-
-### Target Users and Scenarios
-- **User Groups:** [Characteristic description]
-- **Usage Scenarios:** [Specific scenario description]
-- **Core Pain Points:** [Problems to solve]
-
-### Value Proposition and Success Metrics
-- **Value Proposition:** [Core value]
-- **Success Metrics:** [Quantifiable metrics]
-
-### Humanistic Care
-[Inclusivity/Privacy/Ethical considerations]
-<!-- Product Analysis section end -->
-
-## Change Content
-1. [Change point 1]
-2. [Change point 2]
-
-## Impact Scope
-- **Modules:** [List]
-- **Files:** [List]
-- **APIs:** [List]
-- **Data:** [List]
-
-## Core Scenarios
-
-<!-- 🔁 Repeat the following format for each requirement -->
-### Requirement: [Requirement Name]
-**Module:** [Owning module name]
-[Requirement brief]
-
-#### Scenario: [Scenario Name]
-[Condition description]
-- [Expected result]
-<!-- Loop end -->
-
-## Risk Assessment
-- **Risk:** [Description]
-- **Mitigation:** [Measures]
-```
-
----
-
-### how.md in plan/ and history/
-
-```markdown
-# Technical Design: [Feature Name]
-
-## Technical Solution
-### Core Technologies
-- [Language/Framework/Library]
-
-### Implementation Key Points
-- [Key logic 1]
-- [Key logic 2]
-
-## Architecture Design
-<!-- If architecture changes -->
-```mermaid
-flowchart TD
-    [Chart code]
-```
-
-## Architecture Decision ADR
-<!-- If involves architecture decisions, otherwise omit -->
-### ADR-[Number]: [Decision Title]
-**Context:** [Background and problem]
-**Decision:** [Core decision]
-**Rationale:** [Reasons]
-**Alternatives:** [Solution] → Rejection reason: [Reason]
-**Impact:** [Consequences and risks]
-
-## API Design
-<!-- If API changes -->
-### [METHOD] [Path]
-- **Request:** [Structure]
-- **Response:** [Structure]
-
-## Data Model
-<!-- If data changes -->
-```sql
-[SQL or Schema code]
-```
-
-## Security and Performance
-- **Security:** [Measures]
-- **Performance:** [Optimizations]
-
-## Testing and Deployment
-- **Testing:** [Strategy]
-- **Deployment:** [Process]
-```
-
----
-
-### task.md in plan/ and history/
-
-**Markdown anchor link format generated per actual section titles in why.md**
-
-```markdown
-# Task List: [Feature Name]
-
-Directory: `helloagents/plan/YYYYMMDDHHMM_<feature>/`
-
----
-
-## 1. [Core Feature Module Name]
-- [ ] 1.1 Implement [specific functionality] in `path/to/file.ts`, verify why.md#[requirement-title-anchor]-[scenario-title-anchor]
-- [ ] 1.2 Implement [specific functionality] in `path/to/file.ts`, verify why.md#[requirement-title-anchor]-[scenario-title-anchor], depends on task 1.1
-
-## 2. [Secondary Feature Module Name]
-- [ ] 2.1 Implement [specific functionality] in `path/to/file.ts`, verify why.md#[requirement-title-anchor]-[scenario-title-anchor], depends on task 1.2
-
-## 3. Security Check
-- [ ] 3.1 Execute security check (per G9: input validation, sensitive info handling, permission control, EHRB risk avoidance)
-
-## 4. Documentation Update
-- [ ] 4.1 Update <knowledge base file>
-
-## 5. Testing
-- [ ] 5.1 Implement scenario test in `tests/integration/xxx.test.ts`: [Scenario 1 name], verification points: [key verification point list]
-```
-
-**Task Status Symbols:** Follow G11 definition
-
----
-
-## A3 | Version Number Parsing Rules
-
-### Multi-Language Version Number Sources (Priority: Primary > Secondary)
-
-| Language/Framework | Primary Source | Secondary Source |
-|-------------------|----------------|------------------|
-| JavaScript/TypeScript | package.json → version | index.js/ts → VERSION constant |
-| Python | pyproject.toml → [project].version | setup.py/__init__.py → __version__ |
-| Java(Maven) | pom.xml → \<version\> | - |
-| Java(Gradle) | gradle.properties/build.gradle → version | - |
-| Go | Git tag | - |
-| Rust | Cargo.toml → [package].version | - |
-| .NET | .csproj → \<Version\>/\<AssemblyVersion\> | - |
-| C/C++ | CMakeLists.txt → project(...VERSION) | Header file → #define PROJECT_VERSION |
-
-**Purpose:** Referenced by G7 version management rules to determine version number file locations for projects in each language.

package/bin/cli.js

@@ -1,85 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * HelloAGENTS CLI - Entry Point
- *
- * CLI tool to configure HelloAGENTS for Claude Code and Codex
- */
-
-'use strict';
-
-const { parseArgs } = require('../lib/args');
-const { run } = require('../lib/index');
-const { error, info } = require('../lib/output');
-const pkg = require('../package.json');
-
-const HELP_TEXT = `
-HelloAGENTS - AI编程模块化技能系统配置工具
-
-Usage: npx helloagents [options]
-
-Options:
-  --platform <claude|codex>  目标平台（跳过交互）
-  --lang <cn|en>             语言版本（跳过交互）
-  --yes, -y                  全部使用默认选项（非交互）
-  --dry-run                  仅显示将执行的操作，不实际写入
-  --skills-only              仅更新 skills/helloagents，跳过顶层配置文件
-  --overwrite                强制覆盖顶层配置文件（不生成 .new）
-  --no-backup                跳过备份步骤
-  --no-color                 禁用 ANSI 颜色输出
-  --help, -h                 显示帮助
-  --version, -v              显示版本
-
-Examples:
-  npx helloagents                          # 交互式安装
-  npx helloagents -y                       # 使用默认选项安装
-  npx helloagents --platform claude --lang cn  # 指定平台和语言
-  npx helloagents --dry-run                # 预览将执行的操作
-  npx helloagents --skills-only            # 仅更新技能模块
-
-Documentation: https://github.com/hellowind777/helloagents
-`;
-
-async function main() {
-  try {
-    // Parse command line arguments
-    const options = parseArgs(process.argv.slice(2));
-
-    // Handle --help
-    if (options.help) {
-      console.log(HELP_TEXT);
-      process.exit(0);
-    }
-
-    // Handle --version
-    if (options.version) {
-      console.log(`helloagents v${pkg.version}`);
-      process.exit(0);
-    }
-
-    // Run main logic
-    await run(options);
-
-  } catch (err) {
-    // Handle known error types
-    if (err.code === 'MUTEX_PARAMS') {
-      error(err.message);
-      process.exit(1);
-    }
-
-    if (err.code === 'INVALID_PARAM') {
-      error(err.message);
-      process.exit(1);
-    }
-
-    // Handle unexpected errors
-    error(`发生错误: ${err.message}`);
-    if (process.env.DEBUG) {
-      console.error(err.stack);
-    }
-    process.exit(1);
-  }
-}
-
-// Run CLI
-main();

package/lib/args.js

@@ -1,106 +0,0 @@
-/**
- * Args - Command line argument parsing
- */
-
-'use strict';
-
-/**
- * Parse command line arguments
- * @param {string[]} argv - Command line arguments (without node and script)
- * @returns {Object} Parsed options
- * @throws {Error} On invalid arguments
- */
-function parseArgs(argv) {
-  const options = {
-    platform: null,
-    lang: null,
-    yes: false,
-    dryRun: false,
-    skillsOnly: false,
-    overwrite: false,
-    noBackup: false,
-    noColor: false,
-    help: false,
-    version: false,
-  };
-
-  for (let i = 0; i < argv.length; i++) {
-    const arg = argv[i];
-
-    switch (arg) {
-      case '--platform':
-        options.platform = argv[++i];
-        if (!options.platform || !['claude', 'codex'].includes(options.platform)) {
-          const err = new Error(`无效的平台参数: ${options.platform}。有效值: claude, codex`);
-          err.code = 'INVALID_PARAM';
-          throw err;
-        }
-        break;
-
-      case '--lang':
-        options.lang = argv[++i];
-        if (!options.lang || !['cn', 'en'].includes(options.lang)) {
-          const err = new Error(`无效的语言参数: ${options.lang}。有效值: cn, en`);
-          err.code = 'INVALID_PARAM';
-          throw err;
-        }
-        break;
-
-      case '--yes':
-      case '-y':
-        options.yes = true;
-        break;
-
-      case '--dry-run':
-        options.dryRun = true;
-        break;
-
-      case '--skills-only':
-        options.skillsOnly = true;
-        break;
-
-      case '--overwrite':
-        options.overwrite = true;
-        break;
-
-      case '--no-backup':
-        options.noBackup = true;
-        break;
-
-      case '--no-color':
-        options.noColor = true;
-        break;
-
-      case '--help':
-      case '-h':
-        options.help = true;
-        break;
-
-      case '--version':
-      case '-v':
-        options.version = true;
-        break;
-
-      default:
-        if (arg.startsWith('-')) {
-          const err = new Error(`未知参数: ${arg}`);
-          err.code = 'INVALID_PARAM';
-          throw err;
-        }
-        break;
-    }
-  }
-
-  // Check for mutually exclusive options
-  if (options.skillsOnly && options.overwrite) {
-    const err = new Error('--skills-only 与 --overwrite 不能同时使用');
-    err.code = 'MUTEX_PARAMS';
-    throw err;
-  }
-
-  return options;
-}
-
-module.exports = {
-  parseArgs,
-};

package/lib/backup.js

@@ -1,81 +0,0 @@
-/**
- * Backup - File and directory backup functionality
- */
-
-'use strict';
-
-const path = require('path');
-const fsPromises = require('fs').promises;
-const { getTimestamp, ensureDir } = require('./utils');
-
-/**
- * Backup a single file
- * @param {string} filePath - Path to file to backup
- * @param {Object} deps - Dependencies
- * @returns {Promise<string>} Backup path
- */
-async function backupFile(filePath, deps = {}) {
-  const fsModule = deps.fs || fsPromises;
-  const timestamp = getTimestamp(deps);
-
-  const dir = path.dirname(filePath);
-  const ext = path.extname(filePath);
-  const base = path.basename(filePath, ext);
-  const backupPath = path.join(dir, `${base}${ext}.backup-${timestamp}`);
-
-  await fsModule.copyFile(filePath, backupPath);
-
-  return backupPath;
-}
-
-/**
- * Backup a directory
- * @param {string} dirPath - Path to directory to backup
- * @param {Object} deps - Dependencies
- * @returns {Promise<string>} Backup path
- */
-async function backupDir(dirPath, deps = {}) {
-  const fsModule = deps.fs || fsPromises;
-  const timestamp = getTimestamp(deps);
-
-  const parent = path.dirname(dirPath);
-  const name = path.basename(dirPath);
-  const backupPath = path.join(parent, `${name}.backup-${timestamp}`);
-
-  // Recursively copy directory
-  await copyDirRecursive(dirPath, backupPath, deps);
-
-  return backupPath;
-}
-
-/**
- * Recursively copy a directory
- * @param {string} src - Source directory
- * @param {string} dest - Destination directory
- * @param {Object} deps - Dependencies
- * @returns {Promise<void>}
- */
-async function copyDirRecursive(src, dest, deps = {}) {
-  const fsModule = deps.fs || fsPromises;
-
-  await ensureDir(dest, deps);
-
-  const entries = await fsModule.readdir(src, { withFileTypes: true });
-
-  for (const entry of entries) {
-    const srcPath = path.join(src, entry.name);
-    const destPath = path.join(dest, entry.name);
-
-    if (entry.isDirectory()) {
-      await copyDirRecursive(srcPath, destPath, deps);
-    } else {
-      await fsModule.copyFile(srcPath, destPath);
-    }
-  }
-}
-
-module.exports = {
-  backupFile,
-  backupDir,
-  copyDirRecursive,
-};