@mison/ling 1.0.0

package/AGENT_FLOW.md

@@ -0,0 +1,609 @@
+#  智能体流程架构
+
+> **灵轨（Ling）** - 完整的 AI 智能体工作流文档
+
+---
+
+##  全流程概览图
+
+```
++-----------------------------------------------------------------+
+|                         USER REQUEST                             |
+---------------------------+------------------------------------+
+                             |
+                             v
++-----------------------------------------------------------------+
+|                    REQUEST CLASSIFICATION                        |
+|  - Analyze intent (build, debug, test, deploy, etc.)           |
+|  - Identify domain (frontend, backend, mobile, etc.)           |
+|  - Detect complexity (simple, medium, complex)                  |
+---------------------------+------------------------------------+
+                             |
+                +------------+------------+
+                |                         |
+                v                         v
+    +-------------------+      +------------------+
+    | WORKFLOW COMMAND  |      |  DIRECT AGENT    |
+    |  (Slash Command)  |      |  ASSIGNMENT      |
+    --------+---------+      -------+---------+
+              |                         |
+              v                         v
+    +-------------------+      +------------------+
+    | /brainstorm       |      | Agent Selection  |
+    | /create           |      | Based on Domain  |
+    | /debug            |      |                  |
+    | /deploy           |      | - frontend-*     |
+    | /enhance          |      | - backend-*      |
+    | /orchestrate      |      | - mobile-*       |
+    | /plan             |      | - database-*     |
+    | /preview          |      | - devops-*       |
+    | /status           |      | - test-*         |
+    | /test             |      | - security-*     |
+    | /ui-ux-pro-max    |      | - game-*         |
+    --------+---------+      -------+---------+
+              |                         |
+              -----------+------------+
+                           |
+                           v
+         +-------------------------------------+
+         |       AGENT INITIALIZATION          |
+         |  - Load agent persona/role          |
+         |  - Load required skills             |
+         |  - Set behavioral mode              |
+         -------------+----------------------+
+                        |
+                        v
+         +-------------------------------------+
+         |      SKILL LOADING PROTOCOL         |
+         |                                      |
+         |  1. Read SKILL.md metadata          |
+         |  2. Load references/ (if needed)    |
+         |  3. Execute scripts/ (if needed)    |
+         |  4. Apply rules and patterns        |
+         -------------+----------------------+
+                        |
+                        v
+         +-------------------------------------+
+         |         TASK EXECUTION              |
+         |                                      |
+         |  - Analyze codebase                 |
+         |  - Apply best practices             |
+         |  - Generate/modify code             |
+         |  - Run validations                  |
+         |  - Execute tests                    |
+         -------------+----------------------+
+                        |
+                        v
+         +-------------------------------------+
+         |      VALIDATION LAYER               |
+         |                                      |
+         |  Quick Check (checklist.py):        |
+         |  - Security scan                    |
+         |  - Code quality (lint/types)        |
+         |  - Schema validation                |
+         |  - Test suite                       |
+         |  - UX audit                         |
+         |  - SEO check                        |
+         |                                      |
+         |  Full Check (verify_all.py):        |
+         |  - All above + Lighthouse           |
+         |  - E2E tests (Playwright)           |
+         |  - Bundle analysis                  |
+         |  - Mobile audit                     |
+         |  - i18n check                       |
+         -------------+----------------------+
+                        |
+                        v
+         +-------------------------------------+
+         |         RESULT DELIVERY             |
+         |  - Present changes to user          |
+         |  - Provide explanations             |
+         |  - Suggest next steps               |
+         ------------------------------------+
+```
+
+---
+
+##  智能体详细流程
+
+### 1. **请求入口类型**
+
+```
+User Input Types:
++-------------------------------------------------------------+
+| A. Natural Language Request                                 |
+|    "Build a React dashboard with charts"                    |
+|                                                              |
+| B. Slash Command                                            |
+|    "/create feature: user authentication"                   |
+|                                                              |
+| C. Domain-Specific Request                                  |
+|    "Optimize database queries" -> database-architect         |
+|    "Fix security vulnerability" -> security-auditor          |
+|    "Deploy to AWS" -> devops-engineer                        |
+------------------------------------------------------------+
+```
+
+#### 苏格拉底门禁协议
+
+在实现前先确认：
+
+- **新功能** -> 至少提出 3 个战略性问题
+- **Bug 修复** -> 确认理解 + 询问影响
+- **模糊请求** -> 询问目的、用户、范围
+
+### 2. **智能体选择矩阵**
+
+#### 智能体路由检查清单（强制）
+
+在任何代码/设计工作之前：
+
+| 步骤 | 检查项 | 未满足时 |
+| ---- | ---------------------------- | ---------------------------------------- |
+| 1    | 识别正确智能体               | -> 分析请求领域                           |
+| 2    | 阅读智能体的 .md 文件         | -> 打开 `.agent/agents/{agent}.md`        |
+| 3    | 宣布智能体                   | -> ` Applying knowledge of @[agent]...` |
+| 4    | 从 frontmatter 加载 skills    | -> 检查 `skills:` 字段                    |
+
+```
+Request Domain -> Agent Mapping:
+
++----------------------+---------------------+--------------------------+
+| Domain               | Primary Agent       | Skills Loaded            |
+---------------------+---------------------+--------------------------+
+| UI/UX Design         | frontend-specialist | nextjs-react-expert       |
+|                      |                     | frontend-design          |
+|                      |                     | tailwind-patterns        |
+|                      |                     | web-design-guidelines    |
+---------------------+---------------------+--------------------------+
+| API Development      | backend-specialist  | api-patterns             |
+|                      |                     | nodejs-best-practices    |
+|                      |                     | rust-pro                 |
+---------------------+---------------------+--------------------------+
+| Database Design      | database-architect  | database-design          |
+---------------------+---------------------+--------------------------+
+| Mobile App           | mobile-developer    | mobile-design            |
+---------------------+---------------------+--------------------------+
+| Game Development     | game-developer      | game-development         |
+---------------------+---------------------+--------------------------+
+| DevOps/Deployment    | devops-engineer     | docker-expert            |
+|                      |                     | deployment-procedures    |
+---------------------+---------------------+--------------------------+
+| Security Audit       | security-auditor    | vulnerability-scanner    |
+---------------------+---------------------+--------------------------+
+| Penetration Testing  | penetration-tester  | red-team-tactics         |
+---------------------+---------------------+--------------------------+
+| Testing              | test-engineer       | testing-patterns         |
+|                      |                     | webapp-testing           |
+|                      |                     | tdd-workflow             |
+---------------------+---------------------+--------------------------+
+| Debugging            | debugger            | systematic-debugging     |
+---------------------+---------------------+--------------------------+
+| Performance          | performance-        | performance-profiling    |
+|                      | optimizer           |                          |
+---------------------+---------------------+--------------------------+
+| SEO                  | seo-specialist      | seo-fundamentals         |
+|                      |                     | geo-fundamentals         |
+---------------------+---------------------+--------------------------+
+| Documentation        | documentation-      | documentation-templates  |
+|                      | writer              |                          |
+---------------------+---------------------+--------------------------+
+| Planning/Discovery   | project-planner     | brainstorming            |
+|                      |                     | plan-writing             |
+|                      |                     | architecture             |
+---------------------+---------------------+--------------------------+
+| Multi-Agent Tasks    | orchestrator        | parallel-agents          |
+|                      |                     | behavioral-modes         |
+---------------------+---------------------+--------------------------+
+```
+
+### 3. **技能加载协议**
+
+```
++-------------------------------------------------------------+
+|                    SKILL LOADING FLOW                        |
+------------------------------------------------------------+
+
+Step 1: Match Request to Skill
++------------------------------------------+
+| User: "Build a REST API"                 |
+|   v                                       |
+| Keyword Match: "API" -> api-patterns      |
+-----------------------------------------+
+                    v
+Step 2: Load Skill Metadata
++------------------------------------------+
+| Read: .agent/skills/api-patterns/        |
+|       - SKILL.md (main instructions)   |
+-----------------------------------------+
+                    v
+Step 3: Load References (if needed)
++------------------------------------------+
+| Read: api-patterns/rest.md               |
+|       api-patterns/graphql.md            |
+|       api-patterns/auth.md               |
+|       api-patterns/documentation.md      |
+-----------------------------------------+
+                    v
+Step 4: Execute Scripts (if needed)
++------------------------------------------+
+| Run: scripts/api_validator.py            |
+|      (validates API design)              |
+-----------------------------------------+
+                    v
+Step 5: Apply Knowledge
++------------------------------------------+
+| Agent now has:                           |
+| - API design patterns                    |
+| - Authentication strategies              |
+| - Documentation templates                |
+| - Validation scripts                     |
+-----------------------------------------+
+```
+
+### 相关技能模式
+
+Skills（技能）相互联动：
+- `frontend-design` -> `web-design-guidelines`（编码后）
+- `web-design-guidelines` -> `frontend-design`（编码前）
+
+> **注意**：Scripts（脚本）不会自动执行。AI 仅提出运行建议，需用户确认。
+
+### 4. **工作流命令执行**
+
+```
+Slash Command Flow:
+
+/brainstorm
+    v
+    1. Load: brainstorming skill
+    2. Apply: Socratic questioning
+    3. Output: Structured discovery document
+
+/create
+    v
+    1. Detect: Project type (web/mobile/api/game)
+    2. Load: app-builder skill + domain-specific skills
+    3. Select: Template from app-builder/templates/
+    4. Scaffold: Generate project structure
+    5. Validate: Run checklist.py
+
+/debug
+    v
+    1. Load: systematic-debugging skill
+    2. Analyze: Error logs, stack traces
+    3. Apply: Root cause analysis
+    4. Suggest: Fix with code examples
+    5. Test: Verify fix works
+
+/deploy
+    v
+    1. Load: deployment-procedures skill
+    2. Detect: Platform (Vercel, AWS, Docker, etc.)
+    3. Prepare: Build artifacts
+    4. Execute: Deployment scripts
+    5. Verify: Health checks
+    6. Output: Deployment URL
+
+/test
+    v
+    1. Load: testing-patterns + webapp-testing skills
+    2. Detect: Test framework (Jest, Vitest, Playwright)
+    3. Generate: Test cases
+    4. Execute: Run tests
+    5. Report: Coverage + results
+
+/orchestrate
+    v
+    1. Load: parallel-agents skill
+    2. Decompose: Task into subtasks
+    3. Assign: Each subtask to specialist agent
+    4. Coordinate: Parallel execution
+    5. Merge: Combine results
+    6. Validate: Run full verification
+
+/plan
+    v
+    1. Load: plan-writing + architecture skills
+    2. Analyze: Requirements
+    3. Break down: Tasks with estimates
+    4. Output: Structured plan with milestones
+
+/restore-localize-compat
+    v
+    1. Load: i18n-localization + intelligent-routing skills
+    2. Compare: current doc vs reference baseline
+    3. Restore: mechanism structure first
+    4. Localize: semantic Chinese translation only
+    5. Verify: compatibility notes remain minimal
+
+/ui-ux-pro-max
+    v
+    1. Load: ui-ux-pro-max skill
+    2. Access: 50 design styles
+    3. Access: 21 color palettes
+    4. Access: 50 font combinations
+    5. Generate: Professional UI with selected style
+```
+
+### 5. **多智能体编排**
+
+```
+Complex Task -> /orchestrate -> Multiple Specialist Personas
+
+Example: "Build a full-stack e-commerce app"
+
++-------------------------------------------------------------+
+|                     ORCHESTRATOR AGENT                       |
+|  Decomposes task into sequential workstreams                |
+------------------------------------------------------------+
+                              |
+        +---------------------+---------------------+
+        |                     |                     |
+        v                     v                     v
++---------------+   +---------------+   +---------------+
+| FRONTEND      |   | BACKEND       |   | DATABASE      |
+| SPECIALIST    |   | SPECIALIST    |   | ARCHITECT     |
+|               |   |               |   |               |
+| Skills:       |   | Skills:       |   | Skills:       |
+| - react-*     |   | - api-*       |   | - database-*  |
+| - nextjs-*    |   | - nodejs-*    |   | - prisma-*    |
+| - tailwind-*  |   | - nestjs-*    |   |               |
+|               |   |               |   |               |
+| Builds:       |   | Builds:       |   | Builds:       |
+| - UI/UX       |   | - REST API    |   | - Schema      |
+| - Components  |   | - Auth        |   | - Migrations  |
+| - Pages       |   | - Business    |   | - Indexes     |
+------+-------+   ------+-------+   ------+-------+
+        |                   |                   |
+        ----------------+-+-------------------+
+                          |
+                          v
+        +-------------------------------------+
+        |      CODE COHERENCE                 |
+        |  - AI maintains consistency         |
+        |  - Sequential context switching     |
+        |  - Ensure API contracts match       |
+        -------------+----------------------+
+                       |
+                       v
+        +-------------------------------------+
+        |    VALIDATION (All Agents)          |
+        |  - test-engineer -> Tests            |
+        |  - security-auditor -> Security      |
+        |  - performance-optimizer -> Perf     |
+        -------------+----------------------+
+                       |
+                       v
+        +-------------------------------------+
+        |    DEPLOYMENT                       |
+        |  - devops-engineer -> Deploy         |
+        ------------------------------------+
+```
+
+### 6. **验证与质量门禁**
+
+```
++-------------------------------------------------------------+
+|                 VALIDATION PIPELINE                          |
+------------------------------------------------------------+
+
+During Development (Quick Checks):
++------------------------------------------+
+| python .agent/scripts/checklist.py .     |
+-----------------------------------------+
+| OK Security Scan (vulnerabilities)        |
+| OK Code Quality (ESLint, TypeScript)      |
+| OK Schema Validation (Prisma/DB)          |
+| OK Test Suite (Unit tests)                |
+| OK UX Audit (Accessibility)               |
+| OK SEO Check (Meta tags, performance)     |
+-----------------------------------------+
+        Time: ~30 seconds
+
+Pre-Deployment (Full Verification):
++------------------------------------------------------+
+| python .agent/scripts/verify_all.py .                |
+|        --url http://localhost:3000                   |
+-----------------------------------------------------+
+| OK All Quick Checks                                   |
+| OK Lighthouse Audit (Core Web Vitals)                 |
+| OK Playwright E2E Tests                               |
+| OK Bundle Analysis (Size, tree-shaking)               |
+| OK Mobile Audit (Responsive, touch targets)           |
+| OK i18n Check (Translations, locale)                  |
+-----------------------------------------------------+
+        Time: ~3-5 minutes
+```
+
+---
+
+##  技能与脚本映射
+
+```
+Skills with Automated Scripts:
+
++-------------------------+----------------------------------+
+| Skill                   | Script                           |
+------------------------+----------------------------------+
+| api-patterns            | scripts/api_validator.py         |
+| database-design         | scripts/schema_validator.py      |
+| frontend-design         | scripts/accessibility_checker.py |
+|                         | scripts/ux_audit.py              |
+| geo-fundamentals        | scripts/geo_checker.py           |
+| i18n-localization       | scripts/i18n_checker.py          |
+| lint-and-validate       | scripts/lint_runner.py           |
+|                         | scripts/type_coverage.py         |
+| mobile-design           | scripts/mobile_audit.py          |
+| nextjs-react-expert     | scripts/react_performance_checker.py |
+| performance-profiling   | scripts/lighthouse_audit.py      |
+| seo-fundamentals        | scripts/seo_checker.py           |
+| testing-patterns        | scripts/test_runner.py           |
+| vulnerability-scanner   | scripts/security_scan.py         |
+| webapp-testing          | scripts/playwright_runner.py     |
+------------------------+----------------------------------+
+```
+
+---
+
+##  完整请求生命周期示例
+
+```
+User Request: "Build a Next.js dashboard with authentication"
+
+1. REQUEST CLASSIFICATION
+   - Type: Build new feature
+   - Domain: Frontend + Backend
+   - Complexity: Medium-High
+   - Suggested: /create or /orchestrate
+
+2. WORKFLOW SELECTION
+   - User chooses: /orchestrate (multi-agent approach)
+
+3. ORCHESTRATOR DECOMPOSITION
+   - Frontend: Dashboard UI (React components)
+   - Backend: Auth API (JWT, session management)
+   - Database: User schema (Prisma)
+   - Testing: E2E auth flow
+
+4. AGENT ASSIGNMENT
+   - frontend-specialist
+   |   - Skills: nextjs-react-expert, tailwind-patterns, frontend-design
+   - backend-specialist
+   |   - Skills: api-patterns, nodejs-best-practices
+   - database-architect
+   |   - Skills: database-design
+   - test-engineer
+       - Skills: testing-patterns, webapp-testing
+
+5. SEQUENTIAL MULTI-DOMAIN EXECUTION
+   Note: AI processes each domain sequentially, switching context between specialist "personas."
+   This is NOT true parallel execution but simulated multi-agent behavior.
+
+   - Frontend builds:
+   |   - app/dashboard/page.tsx (Server Component)
+   |   - components/DashboardLayout.tsx
+   |   - components/LoginForm.tsx
+   |   - lib/auth-client.ts
+   - Backend builds:
+   |   - app/api/auth/login/route.ts
+   |   - app/api/auth/logout/route.ts
+   |   - lib/jwt.ts
+   |   - middleware.ts
+   - Database builds:
+   |   - prisma/schema.prisma (User, Session models)
+   |   - prisma/migrations/
+   - Testing builds:
+       - tests/auth.spec.ts (Playwright)
+       - tests/dashboard.spec.ts
+
+6. CODE INTEGRATION
+   Reality Note: AI writes code as a continuous stream, maintaining consistency.
+   There is no "merge" step - it's all generated coherently from the start.
+
+   - AI maintains coherence across domains
+       - Resolves import paths
+       - Ensures type safety
+       - Connects API routes to UI
+
+7. VALIDATION
+   - checklist.py
+   |   OK Security: No leaked secrets
+   |   OK Lint: No ESLint errors
+   |   OK Types: TypeScript passes
+   |   OK Tests: Auth flow passes
+   - verify_all.py
+       OK E2E: Login -> Dashboard -> Logout works
+       OK Accessibility: WCAG AA compliant
+       OK Performance: Lighthouse score > 90
+
+8. RESULT DELIVERY
+   - User receives:
+       - Complete codebase
+       - Documentation (how to run)
+       - Test reports
+       - Deployment instructions
+```
+
+---
+
+##  统计与指标
+
+```
++----------------------------------------------------------+
+|                    SYSTEM CAPABILITIES                    |
+---------------------------------------------------------+
+| Total Agents:              20                            |
+| Total Skills:              36                            |
+| Total Workflows:           11                            |
+| Master Scripts:            2 (checklist, verify_all)     |
+| Skill-Level Scripts:       18                            |
+| Coverage:                  ~90% web/mobile development   |
+|                                                          |
+| Supported Frameworks:                                    |
+| - Frontend: React, Next.js, Vue, Nuxt, Astro          |
+| - Backend: Node.js, NestJS, FastAPI, Express          |
+| - Mobile: React Native, Flutter                        |
+| - Database: Prisma, TypeORM, Sequelize                |
+| - Testing: Jest, Vitest, Playwright, Cypress          |
+| - DevOps: Docker, Vercel, AWS, GitHub Actions         |
+---------------------------------------------------------+
+```
+
+---
+
+##  最佳实践
+
+### 各工作流的适用场景
+
+```
+/brainstorm
+  OK Unclear requirements
+  OK Need to explore options
+  OK Complex problem needs breaking down
+
+/create
+  OK New feature in existing project
+  OK Small-to-medium complexity
+  OK Single domain (frontend OR backend)
+
+/orchestrate
+  OK Full-stack features
+  OK Complex multi-step tasks
+  OK Need multiple specialist agents
+
+/debug
+  OK Bug reports
+  OK Unexpected behavior
+  OK Performance issues
+
+/test
+  OK Need test coverage
+  OK Before deployment
+  OK After major changes
+
+/deploy
+  OK Ready to ship
+  OK After all tests pass
+  OK Need production URL
+
+/plan
+  OK Large projects
+  OK Need time estimates
+  OK Team coordination needed
+```
+
+---
+
+##  快速索引
+
+- **架构（Architecture）**: `.agent/ARCHITECTURE.md`
+- **智能体（Agents）**: `.agent/agents/`
+- **技能（Skills）**: `.agent/skills/`
+- **工作流（Workflows）**: `.agent/workflows/`
+- **脚本（Scripts）**: `.agent/scripts/`
+
+---
+
+**最后更新**：2026-01-26
+**版本**：2.0.1

package/CHANGELOG.md

@@ -0,0 +1,43 @@
+# 更新日志
+
+本文件记录灵轨（Ling）的重要变更。
+
+格式基于 [Keep a Changelog](https://keepachangelog.com/en/2.0.0/)，
+本项目遵循 [Semantic Versioning](https://semver.org/spec/v2.0.0.html)。
+
+## [Unreleased]
+
+## [ling-1.0.0] - 2026-03-13
+
+### 版本与标签
+
+- npm 包版本遵循 SemVer：`1.0.0`
+- git tag 与 CLI 显示统一使用：`ling-1.0.0`
+
+### 新增
+
+- 品牌更名基础设施：
+  - 主命令切换为 `ling`
+  - `ag-kit` 保留兼容入口
+  - 目标目录结构：`gemini -> .agent/`，`codex -> .agents/`
+  - 控制目录、索引和备份默认迁移到 `~/.ling/`
+  - `antigravity.rules` 收敛为 `ling.rules`
+- Spec Profile 全局层最小闭环：
+  - `ling spec status`
+  - `ling spec enable`
+  - `ling spec disable`
+  - 内置 `harness-engineering` 与 `cybernetic-systems-engineering`
+  - 内置 templates / references 资产与回退能力
+
+### 修复
+
+- 分发模板与脚本文本清理装饰性字符：避免在模板文本与脚本输出中使用 Emoji 或装饰性 Unicode，提升跨平台终端显示一致性。
+- Web 文档站快捷键提示对齐跨平台：搜索入口提示使用 `Cmd + K`（macOS）或 `Ctrl + K`（其他平台）。
+- 安全扫描器稳定性改进：减少自扫误报、提升依赖锁文件识别准确性，并验证 Web 基础安全响应头配置。
+
+## Legacy
+
+本项目在 Ling 重启前的 2.x/3.x 版本记录已冻结，不再维护。
+
+[Unreleased]: https://github.com/MisonL/Ling/compare/ling-1.0.0...HEAD
+[ling-1.0.0]: https://github.com/MisonL/Ling/releases/tag/ling-1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 VUDOVN
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.