ai-first-engineering

团队中人工智能代理生成大部分实施输出的工程运营模型。

144,923 stars

About this skill

The AI-First Engineering skill outlines a comprehensive operational model for engineering teams where AI agents generate a significant portion of the implementation output. It provides a strategic framework for AI agents to understand and advise on optimal processes, architecture, and review methodologies within such environments. Key areas covered include: * **Process Transformation**: Shifting focus from typing speed to planning quality, prioritizing evaluation coverage over subjective confidence, and directing code review emphasis from syntax to system behavior. * **Architectural Requirements**: Advocating for AI-friendly architectures characterized by clear boundaries, stable contracts, typed interfaces, and deterministic tests, explicitly avoiding implicit behaviors hidden in conventions. * **Code Review in AI-First Teams**: Guiding reviews to concentrate on critical aspects like behavioral regression, security assumptions, data integrity, fault handling, and release safety, thereby minimizing time spent on issues covered by automation. * **Hiring and Evaluation Signals**: Defining qualities of strong AI-first engineers, such as clarity in breaking down ambiguous work, setting measurable acceptance criteria, generating high-value prompts and evaluations, and performing risk control under delivery pressure. * **Testing Standards**: Emphasizing higher testing standards for AI-generated code, including robust regression coverage for domain requirements, explicit boundary condition assertions, and integration checks at interface boundaries. This skill enables an AI agent to act as an expert consultant for implementing and refining AI-first engineering practices.

Best use case

Designing engineering workflows for teams heavily leveraging AI for code generation; establishing code review standards in AI-driven development; architecting systems to be more amenable to AI-assisted development; advising on best practices for an AI-first engineering team; or setting up robust testing strategies for AI-generated code.

团队中人工智能代理生成大部分实施输出的工程运营模型。

Improved efficiency and quality in AI-assisted development workflows; more robust, maintainable, and secure AI-generated codebases; streamlined and highly effective code review processes; architectures designed for optimal AI integration and output; and a clear, well-defined framework for operating a successful AI-first engineering team.

Practical example

Example input

As an AI expert in software engineering, help me design an optimal engineering workflow for a new project where our team will be using AI agents to generate 70% of the implementation code. Focus on process, architecture, and code review best practices.

Example output

To design an optimal AI-first engineering workflow for your project, consider these best practices:

**Process Transformation:**
1.  **Prioritize Planning Quality:** Shift focus from raw typing speed to thorough, high-quality planning and problem decomposition. Clear, precise requirements are paramount for effective AI generation.
2.  **Emphasize Evaluation Coverage:** Move beyond subjective confidence. Implement robust, objective evaluation metrics and comprehensive test coverage to validate AI outputs.
3.  **Review System Behavior:** Code reviews should concentrate on the overall system behavior, architectural adherence, and functional correctness, rather than superficial syntax or style which automation can handle.

**Architectural Requirements:**
1.  **Clear Boundaries:** Design modules and components with explicit, well-defined responsibilities and boundaries.
2.  **Stable Contracts:** Establish stable APIs and interfaces that minimize breaking changes, providing reliable targets for AI agents.
3.  **Typed Interfaces:** Utilize strongly typed languages and interfaces to reduce ambiguity and provide explicit context for AI code generation.
4.  **Deterministic Tests:** Ensure tests are deterministic and reliable, serving as a consistent validation mechanism for AI-generated code. Avoid implicit behaviors scattered across hidden conventions.

**Code Review Focus in AI-First Teams:**
Reviews should strategically concentrate on:
*   Behavioral Regression
*   Security Assumptions
*   Data Integrity
*   Robust Fault Handling
*   Release Safety
Minimize time spent on stylistic issues already covered by automated linters or formatters.

**Testing Standards:**
Elevate testing requirements for AI-generated code:
*   Mandate comprehensive regression test coverage for all involved domain requirements.
*   Explicitly assert boundary conditions and edge cases.
*   Implement integration checks at all interface boundaries to ensure component interoperability.

When to use this skill

  • When a team is transitioning to or optimizing an AI-first development paradigm; when an AI agent is tasked with advising on process improvements, architectural decisions, or code quality in an AI-assisted environment; or when defining development guidelines and testing strategies for projects with significant AI code generation.

When not to use this skill

  • For direct code generation tasks (this skill provides the *how* for AI-assisted generation, not the *act* of generation itself); in teams not utilizing AI for code generation; or for trivial tasks where the overhead of applying these guidelines is not justified.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/ai-first-engineering/SKILL.md --create-dirs "https://raw.githubusercontent.com/affaan-m/everything-claude-code/main/docs/zh-CN/skills/ai-first-engineering/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/ai-first-engineering/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How ai-first-engineering Compares

Feature / Agentai-first-engineeringStandard Approach
Platform SupportClaudeLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

团队中人工智能代理生成大部分实施输出的工程运营模型。

Which AI agents support this skill?

This skill is designed for Claude.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

SKILL.md Source

# 人工智能优先工程

在为由人工智能辅助代码生成的团队设计流程、评审和架构时,使用此技能。

## 流程转变

1. 规划质量比打字速度更重要。
2. 评估覆盖率比主观信心更重要。
3. 评审重点从语法转向系统行为。

## 架构要求

优先选择对智能体友好的架构:

* 明确的边界
* 稳定的契约
* 类型化的接口
* 确定性的测试

避免隐含的行为分散在隐藏的惯例中。

## 人工智能优先团队中的代码评审

评审关注:

* 行为回归
* 安全假设
* 数据完整性
* 故障处理
* 发布安全性

尽量减少花在已由自动化覆盖的风格问题上的时间。

## 招聘和评估信号

强大的人工智能优先工程师:

* 能清晰地分解模糊的工作
* 定义可衡量的验收标准
* 生成高价值的提示和评估
* 在交付压力下执行风险控制

## 测试标准

提高生成代码的测试标准:

* 对涉及的领域要求回归测试覆盖率
* 明确的边界情况断言
* 接口边界的集成检查

Related Skills

search-first

144923
from affaan-m/everything-claude-code

Research-before-coding workflow. Search for existing tools, libraries, and patterns before writing custom code. Systematizes the "search for existing solutions before implementing" approach. Use when starting new features or adding functionality.

DevelopmentClaude

workspace-surface-audit

144923
from affaan-m/everything-claude-code

Audit the active repo, MCP servers, plugins, connectors, env surfaces, and harness setup, then recommend the highest-value ECC-native skills, hooks, agents, and operator workflows. Use when the user wants help setting up Claude Code or understanding what capabilities are actually available in their environment.

DevelopmentClaude

safety-guard

144923
from affaan-m/everything-claude-code

Use this skill to prevent destructive operations when working on production systems or running agents autonomously.

DevelopmentClaude

repo-scan

144923
from affaan-m/everything-claude-code

Cross-stack source code asset audit — classifies every file, detects embedded third-party libraries, and delivers actionable four-level verdicts per module with interactive HTML reports.

DevelopmentClaude

project-flow-ops

144923
from affaan-m/everything-claude-code

Operate execution flow across GitHub and Linear by triaging issues and pull requests, linking active work, and keeping GitHub public-facing while Linear remains the internal execution layer. Use when the user wants backlog control, PR triage, or GitHub-to-Linear coordination.

DevelopmentClaude

manim-video

144923
from affaan-m/everything-claude-code

Build reusable Manim explainers for technical concepts, graphs, system diagrams, and product walkthroughs, then hand off to the wider ECC video stack if needed. Use when the user wants a clean animated explainer rather than a generic talking-head script.

DevelopmentClaude

laravel-plugin-discovery

144923
from affaan-m/everything-claude-code

Discover and evaluate Laravel packages via LaraPlugins.io MCP. Use when the user wants to find plugins, check package health, or assess Laravel/PHP compatibility.

DevelopmentClaude

design-system

144923
from affaan-m/everything-claude-code

Use this skill to generate or audit design systems, check visual consistency, and review PRs that touch styling.

DevelopmentClaude

click-path-audit

144923
from affaan-m/everything-claude-code

Trace every user-facing button/touchpoint through its full state change sequence to find bugs where functions individually work but cancel each other out, produce wrong final state, or leave the UI in an inconsistent state. Use when: systematic debugging found no bugs but users report broken buttons, or after any major refactor touching shared state stores.

DevelopmentClaude

ck

144923
from affaan-m/everything-claude-code

Persistent per-project memory for Claude Code. Auto-loads project context on session start, tracks sessions with git activity, and writes to native memory. Commands run deterministic Node.js scripts — behavior is consistent across model versions.

DevelopmentClaude

canary-watch

144923
from affaan-m/everything-claude-code

Use this skill to monitor a deployed URL for regressions after deploys, merges, or dependency upgrades.

DevelopmentClaude

benchmark

144923
from affaan-m/everything-claude-code

Use this skill to measure performance baselines, detect regressions before/after PRs, and compare stack alternatives.

DevelopmentClaude