SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场synthesis-project-management

synthesis-project-management

办公与效率

查看项目

更新于 10-22 18:15

技能介绍

用途

Synthesis Project Management 是一套轻量级项目管理系统，为人类与 AI 智能体协作设计，核心目标是让项目状态在对话会话切换、上下文压缩（context compaction）以及不同智能体工具之间保持连续。系统认为聊天历史、模型记忆和压缩摘要都不足以充当持久记忆，因此把项目文件本身作为可版本控制的“持久记忆层”，使用户在一个智能体环境中暂停后，能在另一个环境中继续推进。

主要能力

  • 单一项目索引：所有项目记录在 projects/index.yaml 中，状态是字段而非文件夹（active、paused、ongoing、completed、archived），状态变化无需移动目录。
  • 三层上下文架构：CONTEXT.md 为工作记忆，保存当前状态、活跃任务与近期会话，硬性预算不超过 150 行；REFERENCE.md 为语义记忆，保存团队、URL、架构等稳定事实，建议不超过 300 行，按需原地更新；sessions/YYYY-MM.md 为情节记忆，按月追加归档会话日志，无行数预算。
  • 归档协议：会话开始时若 CONTEXT.md 超过 120 行，先将已完成任务与旧会话日志归档到 sessions/、稳定事实迁入 REFERENCE.md，确认目标文件中内容存在后再从 CONTEXT.md 删除，即“先归档、后删除”的两阶段提交。
  • 经验沉淀：lessons/ 目录存放跨项目错误、洞察与模式，文件名以日期前缀（YYYY-MM-DD-topic-slug.md）便于按时间发现；事件类使用 type: incident，模式类使用 type: pattern。
  • 智能体溯源：多个代理实质参与时，在会话日志末尾为每个贡献代理添加一行归因信息，记录代理、模型、投入、范围、验证情况与引用；模型与投入仅在明确提供时记录，否则写 unknown，不记录密钥。
  • 跨会话协调：并行运行的多个根会话共享位于 ~/.synthesis/coordination/active-sessions.md 的协调板，登记项目、工作树、分支、上下文角色与声明区域，通过 scripts/coordination.py 提供原子且带文件锁的 claim、heartbeat、release、message、inbox、whoami、stale、check-staged 等命令。
  • 状态恢复：会话开始时用 scripts/project_state.py resolve 解析 Git 跟踪的索引，只采用其因果选定的状态；存在 CURRENT_STATE.json 时一并读取并校验哈希与语义。

使用方式

系统需要配置若干用户专属路径：ai_knowledge_workspace（如 ai-knowledge-{workspace}）、projects_path（projects/）、index_file（projects/index.yaml）、lessons_path（lessons/）。

典型会话流程：开始时读取协调板、解析项目状态、阅读 CONTEXT.md 与最新会话、检查行数并搜索 lessons/；工作中每完成一项任务就更新 CONTEXT.md；结束时完成最终更新、按需归档、按需添加归因行、释放协调声明。协调命令示例（资料原文）：

python3 <synthesis-project-management-root>/scripts/coordination.py status
python3 <synthesis-project-management-root>/scripts/coordination.py claim \
  --agent "OpenAI Codex" --project example-project \
  --mode autonomous --context-role owner --goal "Cross-client conformance" \
  --workspace "/tmp/synthesis-skills-b @ feature/cross-client" \
  --area "synthesis-skills/**" --area "ai-knowledge-*/projects/**"
python3 <synthesis-project-management-root>/scripts/coordination.py release \
  --session s-6adk-06yc-yqb2

写入前须先声明最小必要区域；若声明冲突，停止该区域写入并通过消息板或用户协调。每个项目只能有一个会话作为规范上下文的所有者，其他会话提交隔离的贡献产物以供后续合并。

适用场景

适合跨多个会话、多个智能体工具（Claude Code、Codex、Cursor 等）长期推进的个人或小团队项目，尤其是需要保留稳定事实、追溯历史会话、沉淀经验教训，或存在并行会话同时编辑同一仓库风险的场景。

限制

工具内置的按项目记忆不能替代本系统，因为它是单工具、单机器且不受版本控制的。系统依赖约定的目录结构与脚本环境；部分高级流程（结构化状态、检查点收据、Stop 收据等）仅适用于已采用 CURRENT_STATE.json 的项目。资料未说明具体安装方法、依赖版本与许可信息，这些需另行确认。