From 314229b7ee7d65bbd816b008211c70f88b1c6c7d Mon Sep 17 00:00:00 2001
From: ryan <ryan@arctel.net>
Date: Sat, 6 Jun 2026 15:49:15 +0800
Subject: [PATCH] =?UTF-8?q?[=E4=BC=98=E5=8C=96]=20Update?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .agent/skills/init-ai-workflow/SKILL.md       |  40 +++++++
 .../skills/init-ai-workflow/scripts/init.sh   | 104 ++++++++++++++++++
 2 files changed, 144 insertions(+)
 create mode 100644 .agent/skills/init-ai-workflow/SKILL.md
 create mode 100755 .agent/skills/init-ai-workflow/scripts/init.sh

diff --git a/.agent/skills/init-ai-workflow/SKILL.md b/.agent/skills/init-ai-workflow/SKILL.md
new file mode 100644
index 00000000..28510657
--- /dev/null
+++ b/.agent/skills/init-ai-workflow/SKILL.md
@@ -0,0 +1,40 @@
+---
+name: init-ai-workflow
+description: 项目级技能：用于在一个全新的项目中初始化 AI 代理开发工作流质量体系，包括生成 AGENTS.md 以及 docs 目录下的设计、规范、参考等基础文档结构。
+---
+
+# Initialize AI Development Workflow Skill
+
+当用户要求在当前（全新或现有）项目中“初始化 AI 开发质量流”、“建立 Agents.md”或“迁移 AI 开发方案”时，你**必须**执行本技能来构建完整的分层文档骨架。
+
+## 目录与文件架构
+
+本技能将在当前工作区根目录下创建以下文件和目录：
+- `AGENTS.md` (入口指引文件)
+- `docs/design/` (系统设计与架构)
+- `docs/guideline/` (开发指导规范)
+- `docs/reference/` (参考手册)
+- `docs/deployment/` (部署指南)
+- `docs/plan/` (开发计划与交接)
+- `docs/changelog/` (变更日志)
+
+*(注意: 默认不需要生成 guide 目录)*
+
+## 执行工作流 (Workflow)
+
+你可以通过执行本项目技能目录中自带的初始化脚本来一键生成所有骨架代码：
+
+1. **运行初始化脚本**
+   使用你的终端执行工具运行此脚本：`bash .agent/skills/init-ai-workflow/scripts/init.sh`
+   *(或者如果在其他项目中迁移，你可以读取本脚本的内容并在目标项目中执行，或者直接复制整个技能目录过去执行)*
+
+2. **验证生成结果**
+   确认 `AGENTS.md` 已在根目录生成，并且 `docs/` 目录下的各子目录 (`design`, `guideline`, `reference`, `deployment`, `plan`, `changelog`) 及其骨架文件均已就绪。
+
+3. **定制化 (如需)**
+   根据当前项目的具体技术栈和需求，对 `docs/guideline/development-constraints.md` 等模板文件中的内容做初步定制或提醒用户自行补充。
+
+## 资源文件说明
+
+本技能依赖以下脚本完成核心工作：
+- `scripts/init.sh`: 包含自动化创建目录和各类 Markdown 模板的 Bash 脚本。
diff --git a/.agent/skills/init-ai-workflow/scripts/init.sh b/.agent/skills/init-ai-workflow/scripts/init.sh
new file mode 100755
index 00000000..fcd36038
--- /dev/null
+++ b/.agent/skills/init-ai-workflow/scripts/init.sh
@@ -0,0 +1,104 @@
+#!/usr/bin/env bash
+# Initialize AI Development Workflow directory structure and template files
+
+echo "Initializing AI Development Workflow..."
+
+# 1. Create root AGENTS.md
+cat << 'EOF' > AGENTS.md
+# AGENTS.md
+
+本文件是本项目 AI 代理接手的入口，不承载详细设计、规范和计划。接手项目时，请根据以下分层文档指引进行阅读与开发：
+
+### 1. 开发指导规范 (AI & Developer Guidelines)
+
+* **必须阅读**：
+  * **[docs/guideline/development-constraints.md](docs/guideline/development-constraints.md)**：掌握核心的开发约束、数据模型规范、API 设计准则及变更准入标准。
+  * **[docs/guideline/Role.md](docs/guideline/Role.md)**：通用的高质量编码准则，包括架构、并发、错误处理、安全及工作流程。
+* **正在进行的开发计划与接手 (Handover & Plans)**：
+  * **[docs/plan/index.md](docs/plan/index.md)**：查看正在进行的开发实现计划（Implementation Plan）与 AI 代理交接文档（Handover），接手项目时优先检查。
+
+### 2. 系统设计与架构 (Design Docs)
+
+* **[docs/design/index.md](docs/design/index.md)**：理解产品范围、系统边界、核心对象及长期约束。
+* **[docs/design/architecture.md](docs/design/architecture.md)**：理解各模块的职责边界与拓扑架构。
+
+### 3. 部署与参考手册 (Deployment & References)
+
+* **[docs/deployment/deployment.md](docs/deployment/deployment.md)**：部署配置，接入、升级与维护策略。
+* **[docs/reference/configuration.md](docs/reference/configuration.md)** / **[cli.md](docs/reference/cli.md)**：支持的环境变量、参数、命令行与配置文件参考。
+
+---
+
+## 开发与执行要求
+
+1. **设计先行**：开发新功能或重要特性时，必须在 `docs/design/` 下创建或更新设计文档。
+2. **遵守约束**：必须严格遵循 `docs/guideline/` 下的所有开发准则与约束。
+3. **开发计划与交接**：正在进行的开发计划或 AI 接手交接发生变化时，在 `docs/plan/` 下更新对应的文档。
+4. **文档与变更日志**：
+   * 代码或配置变更完成后，必须在 [`docs/changelog/index.md`](docs/changelog/index.md) 的 `[Unreleased]` 区块补充对应变更条目。
+   * 纯文档变更（如 `docs/` 下的 Markdown 文档、README 等）不需要写入 changelog。
+EOF
+
+# 2. Create directories
+mkdir -p docs/design docs/guideline docs/reference docs/deployment docs/plan docs/changelog
+
+# 3. Create placeholders
+cat << 'EOF' > docs/guideline/development-constraints.md
+# Development Constraints
+
+请在此填写本项目的核心开发约束、数据模型规范、API 设计准则及变更准入标准。
+EOF
+
+cat << 'EOF' > docs/guideline/Role.md
+# Role Guidelines
+
+请在此填写本项目的通用高质量编码准则，如代码风格、架构原则、并发、错误处理、安全及工作流程。
+EOF
+
+cat << 'EOF' > docs/plan/index.md
+# Plans & Handover
+
+包含以下类型文档：
+1. **Implementation Plan**：开发实现计划。
+2. **Handover**：AI 代理交接文档。
+EOF
+
+cat << 'EOF' > docs/design/index.md
+# System Design
+
+本目录包含系统的详细设计文档。
+EOF
+
+cat << 'EOF' > docs/design/architecture.md
+# Architecture
+
+本项目的整体系统架构与模块拓扑结构设计。
+EOF
+
+cat << 'EOF' > docs/deployment/deployment.md
+# Deployment Guide
+
+本项目的部署和维护指南。
+EOF
+
+cat << 'EOF' > docs/reference/configuration.md
+# Configuration Reference
+
+本项目的配置项、环境变量参考手册。
+EOF
+
+cat << 'EOF' > docs/reference/cli.md
+# CLI Reference
+
+本项目的命令行工具参数说明。
+EOF
+
+cat << 'EOF' > docs/changelog/index.md
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [Unreleased]
+EOF
+
+echo "AI Development Workflow initialized successfully!"