aictxt-manager

name	aictxt-manager
description	生成、维护、修剪AICTXT文档，保持在CRAFT大小限制内。当AICTXT创建和更新时使用。
stage	IMPLEMENTATION_PLANNING
level_supported	["L1","L2","L3"]

aictxt-manager: AI上下文管理

描述

生成、维护、修剪AICTXT（AI Context Text）文档，确保AI代码生成的上下文大小在CRAFT标准限制内。

适用场景

• WORKFLOW_STEP_5 Task S5-2: AICTXT创建初期，生成初始内容
• WORKFLOW_STEP_5 Task S5-3: Self-Reflection中定期审视和修剪
• 实施过程中: 当AICTXT增长过大时，需要修剪

输入

• spec/implementation/ai_context.md（当前AICTXT）
• goal_breakdown.md（GOAL清单）
• scenarios/bdd_test_scenarios.md（关键SC）
• design/（架构和设计约束）
• 当前级别（L1/L2/L3）

输出

• AICTXT审视报告（markdown）
• 当前大小分析（行数/Token数）
• 对标标准：
  • L1: ≤5000字/≤1000行
  • L2: ≤8000字/≤1500行
  • L3: ≤12000字/≤2000行
• 修剪建议（删除/压缩/分离的内容）
• 优化后的AICTXT片段

AICTXT内容结构

标准AICTXT结构（按优先级）：

# AI Context - [项目名] [GOAL ID]

## 业务背景 (A级-关键)
- 用户故事: [US简述]
- 业务价值: [为什么重要]
- 成功标准: [AC清单]

## 技术约束 (A级-关键)
- 技术栈: [框架/库/版本]
- 关键依赖: [外部服务/API]
- 性能要求: [响应时间/并发等]

## 实现目标 (A级-关键)
- GOAL: [G-NNN 描述]
- 关联SC: [SC-NNN, SC-NNN]
- 模块: [module_name]

## 架构概览 (B级-重要)
- 系统设计: [简要架构]
- 关键接口: [API/方法签名]
- 数据流: [输入→处理→输出]

## 已知约束 (B级-重要)
- 不能修改: [列表]
- 必须遵循: [规范/模式]
- 边界条件: [特殊情况]

## 参考链接 (C级-可选)
- 详细设计: [链接]
- 相关GOAL: [链接]
- 测试场景: [链接]

执行策略

第1步: 读取和分析

• 读取当前ai_context.md
• 计算大小（字数/行数/Token数）
• 对标CRAFT标准

第2步: 关键性分析

• A级（关键）: GOAL/SC/业务背景/技术约束
• B级（重要）: 架构概览/关键接口/已知约束
• C级（可选）: 详细实现/背景知识/参考链接

第3步: 修剪方案

• 删除C级非关键内容
• 压缩B级冗余表达（用表格替代长段落）
• 链接到外部文档而非嵌入
• 删除过期或已完成的信息

第4步: 大小优化

优化技巧	效果
用表格替代列表	节省20-30%
删除示例代码	节省30-40%
链接替代嵌入	节省40-50%
缩写术语	节省10-15%

第5步: L1/L2/L3分级

• L1: 仅A级内容，≤1000行
• L2: A级+B级核心，≤1500行
• L3: 完整A级+B级，≤2000行

第6步: 生成优化版本

• 保留关键信息完整
• 删除冗余表达
• 添加清晰的链接

价值

• AI Pair/Devs: AICTXT大小管理，提升AI代码生成效率
• Tech Lead: 清晰的上下文焦点，避免AI分散注意力
• 成本: 减少Token消耗，降低AI调用成本

验收标准

• AICTXT大小在CRAFT限制内
• 关键信息完整（GOAL/SC/约束）
• 冗余信息已删除
• 链接清晰可追溯