TODO.md

PUAX 项目全面改进计划

审阅日期: 2026-03-25 | 审阅人: 萨满·Linus
最近更新: 2026-04-02 | 更新人: AI 全栈分析

当前版本: 3.1.2

---

P0 - 已全部完成 ✅

所有 P0 优先级任务已在 v2.2.0 ~ v3.1.2 期间完成：

• server.ts 重构: 1203行 → 8行 + 5模块拆分
• 类型安全: types.ts 添加，handlers/ 中无 any
• 触发条件外部化: 4 YAML 文件，16种触发类型
• 角色元数据: role-mappings.yaml 411行，50+角色覆盖
• 双版本清理: 42 skills 迁移到 v2，v1 已归档
• CC-BOS 集成: 8维策略空间，50个角色文言文版
• Hook System v3.1.0 完整实现（12个工具）
• 平台导出: Cursor、VSCode、Windsurf、Kiro、CodeBuddy
• 角色分级: P7/P9/P10 体系 + Agent Team
• 文档更新: README、API、用户指南、快速开始、TODO 全面更新
• 修复 5 个角色验证失败
• 标准化 5 步法和 7 项检查清单
• 清理 git 仓库（移除 9,300 误提交文件）

---

P1 - 高优先级

• 依赖注入: 解除 core/ 模块间的 new 硬依赖，改为 DI 容器注入
• 模式匹配增强: 将正则替换为 TF-IDF + 语义相似度混合检测
• 模板简化: 合并 templates/ 下的方法论指南为自动化生成
• 元数据同步验证: CI 步骤中检查 SKILL.md 与 role-mappings.yaml 的一致性
• 测试覆盖率: 核心模块目标 90%+（当前约 80%）
• CI/CD: GitHub Actions 增加 lint + typecheck + test 守门

P2 - 中优先级

• 推荐算法透明化: 在 recommend_role 返回结果中增加逐步得分说明
• i18n 文档同步: README_en.md 与 README.md 保持自动同步
• Bundle 优化: prompts-bundle.ts 拆分为按类别按需加载
• 缓存层: RoleRecommender 添加 Redis/内存缓存
• 路径遍历防护: 输入验证中增加 path traversal 检测
• 使用统计: 全局使用统计收集与分析（匿名）

P3 - 低优先级

• 自定义角色: 支持用户自建角色并加入推荐池
• 更多风味: Amazon、Google、Xiaomi 等企业文化
• 国际化: 多语言触发条件支持（日文、韩文等）
• 性能基准: 建立性能基准测试套件
• 可观测性: OpenTelemetry 集成

---

已完成版本的变更摘要

v3.1.2 (2026-03-26)

• 修复 5 个角色验证失败（SKILL.md 中缺少统一的标准 5 步法/7 检查清单）
• 清理 git 仓库（移除 9,300 误提交文件）

v3.1.0 (2026-03-26)

• Hook System v3.1.0 完整实现
• CC-BOS 集成
• server.ts 重构
• 触发条件外部化
• 平台导出
• 角色分级 + Agent Team

v2.2.0 (2026-03-25)

• server.ts 模块化拆分
• 类型安全改造
• 触发条件 YAML 外部化
• 角色元数据 role-mappings.yaml

v2.1.0 (2026-02-20)

• 角色推荐系统
• 方法论引擎
• 自动触发检测

v2.0.0 (2026-01-15)

• 初始版本发布
• 50+ 激励角色
• MCP 服务器实现