ahmedwaliedz/taskify-ai-kit

# 🚀 TASKIFY AI-Kit (v1.2)     

一个通用的、基于 `.md` 的启动套件，可将任何 AI 编程智能体（Cursor、Claude、Copilot、Windsurf）转变为训练有素、具备生产级能力的 Laravel 技术主管。

## 📖 什么是 Taskify？ **TASKIFY v1.2** 用严格、规范驱动的开发生命周期取代了临时、混乱的提示词（Prompt）方式。它通过**自动化阶段门控**和**零运行时开销**，强制保障了安全性、架构一致性以及长期上下文的高效利用。 只需将此套件放入您的 Laravel 项目中，您的 AI IDE（如 Cursor 或 Claude Code）就能立即理解： - 您首选的架构（瘦 Controller，按需使用 Service）。 - 严格的数据库规则和安全约定（强制使用 FormRequest）。 - 如何正确编写测试（默认 Pest，Service 层采用 TDD）。 - 如何管理其自身的 token 限制（内存压缩）。 ## ⚙️ 核心理念 | 原则 | 实现方式 | |-----------|----------------| | **规范驱动** | `规范 → 澄清 → 计划 → 任务 → 实现 → 结项` | | **默认安全** | 强制使用 `FormRequest`，显式定义 `$fillable`，零 PII 日志记录 | | **反过度工程** | KISS + YAGNI。仅在满足 4 个条件中的 $\ge2$ 个时才使用 Service。 | | **Token 高效** | 隔离的功能上下文，`memory.md` 压缩至 $\le150$ 行。 | | **通用兼容** | 纯 Markdown 工作流。适用于所有 AI IDE，零运行时开销。 | ## 🛠️ 安装 您可以根据自己的工作流偏好，通过两种独立的渠道在您的项目中安装 Taskify： ### 选项 A：Composer 包（自动化，推荐 Laravel 使用） 通过 Composer 安装此套件，并提供 Artisan 命令来生成脚手架文件。**生产环境零运行时开销。** ``` composer require taskify/ai-kit php artisan taskify:install ``` *(使用 `php artisan taskify:install --force` 可覆盖现有文件)。* ### 选项 B：纯 Markdown 套件（零依赖） 非常适合非 Laravel 项目，或者当您倾向于静态、无依赖的方式时使用。 ``` npx degit taskify/ai-kit ./ # 或通过 git： git clone --depth=1 https://github.com/taskify/ai-kit.git ./ ``` ## 🔄 阶段门控工作流 Taskify 强制执行严格的工作流。您使用斜杠命令与 AI 进行交互。**AI 会被指示暂停，并等待您的 `@approve` 后再进入下一阶段。** | 阶段 | 命令 | 输入 | 输出 | 继续条件 | |-------|---------|--------|---------|------------------------| | **1. 规范制定** | `/specify` | 初始想法描述 | `spec.md` | `@approve` | | **2. 需求澄清** | `/clarify` | `spec.md` | 更新后的 `spec.md` + `clarifications.md` | `@resolved` | | **3. 架构规划** | `/plan` | 已批准的 `spec.md` | `plan.md` + Git 分支 | `@approve` | | **4. 任务拆分**| `/tasks` | 已批准的 `plan.md` | `tasks.md` (TDD 顺序) | `@approve` | | **5. 代码实现**| `/implement` | 已批准的 `tasks.md` | 代码 + 测试 + 提交 | 自动重复 | | **6. 结项总结** | `/closure` | 所有任务完成 | 内存压缩 + 摘要 | ✅ 功能就绪 | ## 🧠 内存管理与 Token 效率 AI 的上下文窗口很容易被填满。Taskify 通过本地内存管理解决了这个问题： - **隔离的上下文**：每个功能都存放在独立的文件夹中（例如 `features/user-auth/`）。 - **`memory.md` 限制**：AI 会在 `memory.md` 中跟踪其活动任务和阻碍。 - **自动压缩**：当 `memory.md` 超过 150 行时，将触发 `/compress-memory` 技能。它会丢弃旧日志和已完成的任务细节，仅保留项目元数据、活跃阻碍和架构决策。 ## 🔌 MCP (Model Context Protocol) 集成 Taskify v1.2 原生支持安全、**交互式**的 MCP 工具执行。工具绝不会盲目运行；AI 必须征得您的许可。 **支持的工具：** 1. **`context7`**：获取最新文档以防止幻觉（触发方式：`/index-codebase`）。 2. **`playwright-mcp`**：执行 E2E 测试（触发方式：`/e2e-test`）。 3. **`git-mcp-server`**：安全的本地 Git 操作（分支、提交）。 4. **`github-mcp-server`**：PR 与 Issue 管理。 **配置：** MCP 功能在 `config/taskify.php` 中进行配置。您可以通过 `.env` 文件启用/禁用工具： ``` TASKIFY_MCP_CONTEXT7=false TASKIFY_MCP_PLAYWRIGHT=false TASKIFY_MCP_GIT=true TASKIFY_MCP_GITHUB=false ``` ## 📂 包含哪些内容？（目录结构） 安装后，您的项目根目录中将生成以下结构： ``` .ai/ # The AI's brain (Do not modify unless customizing) ├── README.md # Kit map ├── CHANGELOG.md # Version history ├── mcp-integrations.md # Safe execution rules for external tools ├── rules/ # Core architectural rules │ ├── constitution.md # Strict rules (Security, Architecture, Testing) │ ├── database.md # DB, factories, and migrations rules │ ├── api-conventions.md # API standards and formatting │ ├── token-protocol.md # Memory limit and context rules │ └── version-adaptation.md # Laravel 10 vs 11 vs 12 syntax adaptation ├── skills/ # The commands you use │ ├── specify.md # /specify │ ├── clarify.md # /clarify │ ├── plan.md # /plan │ ├── tasks.md # /tasks │ ├── implement.md # /implement │ ├── closure.md # /closure │ ├── compress-memory.md # Auto-triggered memory compression │ └── index-codebase.md # Context7 integration └── templates/ # Stubs used to generate the feature files features/ # Where your active work lives └── _example_/ # Example feature demonstrating the output format ├── spec.md ├── plan.md ├── tasks.md ├── memory.md └── clarifications.md PROJECT_CONTEXT.md # A high-level map of all features and core decisions ``` ## 🤝 IDE 兼容性与设置 Taskify 是通用的，但根据您使用的 IDE，集成方式会略有不同： - **Cursor**：如果在 `.cursorrules` 或 `.cursor/rules/` 中被引用，AI 会自动读取 `.ai/` 文件。 - **Claude Code**：AI 直接从终端上下文中读取 Markdown 指令。 - **Windsurf**：在 `.windsurfrules` 中添加指向 `.ai/` 目录的规则。 - **GitHub Copilot**：在您的 `.github/copilot-instructions.md` 中引用 `.ai/` 模板。 ## 🚀 快速入门（前 5 分钟） ``` # 1. 在 Laravel 项目中安装 composer require taskify/ai-kit php artisan taskify:install # 2. 创建首个 feature mkdir -p features/user-auth cp .ai/templates/spec.md features/user-auth/spec.md # 3. 从 AI Agent 开始 /specify "I need user authentication with Laravel Sanctum" ``` ## 🤝 IDE 设置指南 | IDE | 配置 | 备注 | |-----|---------------|-------| | **Cursor** | `.cursor/rules/taskify.mdc` → `@include .ai/**/*.md` | 原生斜杠命令 | | **Claude Code** | `.claude/commands/` → 引用 `.ai/skills/` | 直接聊天调用 | | **Windsurf** | `.windsurfrules` → 规则: `.ai/rules/*.md` | 基于 Prompt 的触发 | | **Copilot** | `.github/copilot-instructions.md` → 链接 `.ai/` | 仅限上下文聊天 | ## 📦 安装后会发生什么？ - ✅ 将 `.ai/`（22 个工作流文件）复制到项目根目录 - ✅ 生成 `features/_example_/` 作为参考 - ✅ 发布 `PROJECT_CONTEXT.md` - ✅ 生产环境**零运行时开销** ## 🛠️ 故障排除 | 问题 | 解决方案 | |-------|----------| | AI 忽略 `.ai/` 文件 | 确保 `.cursorrules` 或 `.windsurfrules` 引用了 `.ai/` | | `taskify:install` 失败 | 在 Laravel 根目录中运行（必须包含 `artisan`） | | `memory.md` 超过 150 行 | 运行 `/compress-memory` 命令 | ## 📝 许可证 本套件是开源软件，遵循 [MIT 许可证](https://opensource.org/licenses/MIT) 授权。

标签：AI编程助手, Claude, Cursor, CVE检测, FormRequest, GitHub Copilot, KISS原则, Laravel, MCP工具, OpenVAS, Pest, PHP, TDD, Windsurf, YAGNI原则, 代码规范, 令牌管理, 后端开发, 安全默认, 开发工作流, 提示词工程, 敏捷开发, 数据管道, 生产就绪, 策略决策点, 网络安全研究, 规范驱动开发, 软件工程, 防御加固, 零运行时开销, 静态检测