Update from Sync Service

2026-06-22 11:30:51 +08:00
parent eb80b7a8c1
commit 682e3e52df
52 changed files with 10099 additions and 191 deletions
--- a/AI工程/概念/Agent_as_Code.md
+++ b/AI工程/概念/Agent_as_Code.md
@@ -0,0 +1,131 @@
+# Agent as Code
+
+> 相关：[[Harness工程]]、[[AGENTS.md]]、[[上下文体系]]、[[Skills]]
+
+## 定义
+
+**Agent as Code**是将AI协作的所有文件以代码的方式管理的理念，实现可版本化、可复用、可共享。
+
+**核心思想**：AI的行为由代码（配置文件）决定，而不是由人的临时提示决定。
+
+## 核心特征
+
+### 1. 可版本化
+- 所有配置纳入Git管理
+- 变更有历史记录
+- 可回滚到历史版本
+
+### 2. 可复用
+- 配置可在项目间复用
+- Skills可在团队间共享
+- 最佳实践可沉淀
+
+### 3. 可共享
+- 团队成员共享AI配置
+- 新成员快速上手
+- 统一团队AI行为
+
+## 核心文件
+
+### AGENTS.md（宪法级）
+```markdown
+# 项目信息
+- 项目名称：XXX
+- 技术栈：Java 17, Spring Boot 3.x
+
+# AI行为规则
+1. 代码必须符合规范
+2. 数据库表必须包含时间戳字段
+3. API必须使用RESTful风格
+```
+
+### Skills目录
+```
+skills/
+├── commit-push/
+│   ├── SKILL.md
+│   └── commit.sh
+├── deploy/
+│   ├── SKILL.md
+│   └── deploy.sh
+```
+
+### MCP配置
+```json
+{
+  "mcpServers": {
+    "database": {
+      "command": "node",
+      "args": ["mcp-server-sqlite"]
+    }
+  }
+}
+```
+
+## 实现方式
+
+### 软链接共享配置
+```bash
+# 让多个AI工具共享AGENTS.md
+ln -s ../AGENTS.md .claude/AGENTS.md
+ln -s ../AGENTS.md .opencode/AGENTS.md
+ln -s ../AGENTS.md .cursor/AGENTS.md
+```
+
+### Git管理
+```bash
+git add AGENTS.md
+git add .claude/AGENTS.md
+git commit -m "feat: add AGENTS.md for AI collaboration"
+```
+
+## 目录结构
+
+```
+项目根目录/
+├── AGENTS.md              # 宪法级配置
+├── docs/
+│   ├── standards/         # 标准规范
+│   ├── features/          # 需求规格
+│   ├── designs/           # 设计规格
+│   └── plans/             # 计划规格
+├── skills/                # AI技能
+├── mcp/                   # MCP配置
+├── .claude/               # Claude Code配置
+├── .opencode/             # OpenCode配置
+└── .cursor/               # Cursor配置
+```
+
+## 适用场景
+
+- **团队协作**：多个开发者共享AI配置
+- **多项目**：在多个项目间复用配置
+- **持续迭代**：配置需要持续演进
+- **知识沉淀**：最佳实践需要沉淀
+
+## 优势
+
+- **一致性**：所有AI工具行为一致
+- **可追溯**：配置变更有历史记录
+- **可复用**：Skills和配置可复用
+- **易维护**：修改一处，多处生效
+
+## 挑战
+
+- **初始成本**：需要建立完整的文档体系
+- **维护成本**：需要持续维护配置
+- **学习曲线**：团队需要理解Agent as Code理念
+
+## 最佳实践
+
+1. **从AGENTS.md开始**：先定义最基本的规则
+2. **逐步扩展**：根据实践逐步添加配置
+3. **定期Review**：定期审查和优化配置
+4. **团队共享**：将配置纳入团队知识管理
+
+## 相关概念
+
+- [[Harness工程]]：Agent as Code是Harness的技术实现
+- [[AGENTS.md]]：Agent as Code的核心文件
+- [[上下文体系]]：Agent as Code的文档组织
+- [[Skills]]：Agent as Code的能力单元