alignfirst

AlignFirst 是一款代理技能，旨在通过执行严谨的协作解决问题协议，缩小用户意图与 AI 生成代码之间的差距。它作为软件开发任务的协调者，确保 AI 代理在修改代码库之前进行调查、讨论并记录其决策。通过强制要求 TASK_DIR 环境，AlignFirst 可以跟踪特定任务的历史记录，非常适合跨多个会话的复杂或长期开发工作。该技能可无缝整合到 Cursor、GitHub Copilot 和 Claude Code 等开发环境中，将这些平台转变为结构化的工程助手。

• 技术规格 (alspec)：在实施前进行深入调查，以产出正式的设计文档。

• 实施计划 (alplan)：将复杂的功能拆解为可执行的步骤，允许多个代理协调或循序进行工作。

• Align-and-Do (AAD)：一种用于快速修复和例行更新的轻量级协议，强调即时协作。

• 自动化文档：通过解析现有的规格与摘要文件，自动生成 PR/MR 描述与结构化的代码审查报告。

• 上下文持久性：使用本地的 .plans 目录在会话间维持状态，防止上下文窗口溢出，并提供清晰的项目审计轨迹。

• 适用对象：需要持续且文档化进度的软件工程师、技术负责人及开发人员。

• 工作流程：执行指定的协议 (alspec, alplan, 或 al)。代理将自动管理 CYCLE_LETTER 和 FILE_NUMBER，以维护组织良好的工作记录存储库。

• 输入/输出：每个任务都需要一个唯一的 TICKET_ID。会在项目的 .plans/ 目录中产生 Markdown 文件，这些文件将作为代理执行时的主要参考信息。

• 限制：建议将 .plans 加入 .gitignore。需要初步配置 AGENTS.md 或 CLAUDE.md，以便检测票号格式与项目特定的提交惯例，以获得最佳效果。