# sdlc-portfolio-manager：面向Agentic工作流的本地优先项目管理工具

> 结合Azure DevOps思维模型与Cursor原生设计，为AI辅助软件开发生命周期提供可复用的规则、技能与验证体系

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-05-14T21:15:09.000Z
- 最近活动: 2026-05-14T21:22:27.094Z
- 热度: 150.9
- 关键词: Agentic SDLC, Cursor, project management, local-first, AI-assisted development, OpenSpec, rules library, HITL
- 页面链接: https://www.zingnex.cn/forum/thread/sdlc-portfolio-manager-agentic
- Canonical: https://www.zingnex.cn/forum/thread/sdlc-portfolio-manager-agentic
- Markdown 来源: ingested_event

---

## 背景：AI辅助开发的工具缺口\n\n随着Cursor等AI编程助手的普及，开发者与AI Agent的协作模式正在发生根本性变化。然而，现有的项目管理工具大多设计于"人类开发者独占"的时代，缺乏对AI Agent工作流的原生支持。当人类开发者与AI Agent需要共享任务状态、协作完成工作项时，传统工具显得力不从心。\n\nsdlc-portfolio-manager项目应运而生，它是一个本地优先、单用户优先的项目组合管理工具，专为Agentic SDLC（软件开发生命周期）工作流设计。项目以Cursor作为编排层，让人类开发者和AI Agent能够共享同一个工作项存储。\n\n## 核心定位：Azure DevOps思维 + Paperclip控制平面\n\n项目的设计灵感明确来自两个来源：Azure DevOps Boards的心智模型，以及Paperclip的控制平面人机工程学。目标是打造一款本地、轻量、Cursor原生的项目管理工具，既保留专业项目管理工具的结构性，又具备现代AI工作流所需的灵活性。\n\n当前处于Pre-alpha阶段，采用OpenSpec进行规范驱动开发——每个变更都经过提案→设计→规范→任务→实现→归档的完整流程。\n\n## 三大支柱，统一界面\n\n工具围绕三个紧密耦合的支柱构建，共享一个统一界面：\n\n### 1. 项目组合与工作项管理\n\n采用两级层次结构：项目组合（Portfolio）→ 项目（Project）→ 工作项（Work Item）。每个项目绑定到一个目标代码仓库，人类开发者和Cursor Agent共享同一个工作项存储。\n\n协作通过HITL（Human-in-the-Loop）问题和@提及实现——Agent可以在工作项中标记人类寻求帮助，人类也可以将任务指派给Agent。统一的收件箱界面汇总所有待处理事项，让开发者一目了然地看到需要关注的内容。\n\n### 2. 规则与技能库管理\n\n这是sdlc-portfolio-manager最具特色的功能。它管理一个Cursor规则、技能、自动化、验证器和框架文档的库。开发者可以浏览、编辑这些资产，并将其发布到任意项目的目标仓库。\n\n核心理念是将Agent行为视为可复用、可版本化的资产，而非散落在各个仓库中的代码片段。这种集中化管理让团队能够：\n\n- 建立一致的Agent行为规范\n- 跨项目复用经过验证的技能模板\n- 版本控制Agent能力的演进\n- 审计Agent行为的变更历史\n\n### 3. 发现与验证流程\n\n**发现阶段**：开发者可以将非结构化的想法倾倒进系统，系统自动生成带有验收标准的用户故事草稿，包括价值/复杂度评分、并行化草图。人类审查、编辑、接受后，接受的草稿成为真实的工作项，通过关系图谱连接起来。\n\n**验证阶段**：每个工作项在标记完成前必须通过四个可配置的门禁——质量、安全、缺陷、用户故事验收。每个门禁都是来自库的隔离验证器。如有必要，可以附注理由跳过某个门禁。\n\n## 技术架构：现代Web技术栈\n\n项目采用monorepo结构，技术选型务实而现代：\n\n```\nsdlc-portfolio-manager/\n├── apps/portfolio/      # Next.js (App Router) + SQLite\n├── packages/cli/        # `pc` CLI，供Cursor Agent调用\n├── cursor-templates/    # 种子规则/技能/自动化/验证器\n│   ├── rules/\n│   ├── skills/\n│   ├── automations/\n│   └── validators/\n├── docs/               # 设计原则、入门指南、Agent协议\n└── openspec/           # 规范驱动的变更历史\n```\n\n数据库层使用better-sqlite3 + Drizzle ORM，本地优先设计意味着无需网络连接、无SaaS依赖，数据完全由用户控制。\n\n## UI设计八原则\n\n项目的UI设计遵循八条原则，融合了Jony Ive在Apple的克制美学、Linear/Notion/Things 3的产品设计学派，以及无障碍最佳实践：\n\n1. **默认安静** —— 克制的色彩、慷慨的留白、字体承载层次\n2. **单一规范表面** —— 同一概念不重复展示\n3. **渐进式披露** —— 首屏展示 essentials，深度内容按需呈现\n4. **直接操作优先于模态对话框** —— 拖拽、内联编辑、侧面板\n5. **键盘优先** —— 每个动作都可从键盘触达\n6. **诚实材料** —— 遵循Web惯例，不伪造桌面风格\n7. **关注每个空状态和错误** —— 空状态解释下一步操作\n8. **一致性优先于新奇** —— 同一概念处处使用相同组件\n\n## 架构原则：为演进而设计\n\n项目遵循一套清晰的架构原则，确保长期可维护性：\n\n- **本地优先**：SQLite存储，无网络依赖，无SaaS锁定\n- **单用户先行，多用户随后**：从第一天起使用UUID、user_id和project_id作用域；认证暂存为本地用户\n- **Cursor原生，非Cursor独占**：规则、技能、自动化和后台Agent是一等公民；同时提供干净的REST + CLI接口，支持其他客户端（Claude Code、原始API）\n- **OpenSpec驱动**：每个变更都经过提案→设计→规范→任务→实现→归档\n- **独立可交付**：initial-portfolio-manager是自包含的；agentic-sdlc-framework-port是附加价值，从不作为硬依赖\n\n## 快速开始\n\n项目使用pnpm管理依赖，启动流程简洁：\n\n```bash\npnpm install\npnpm rebuild better-sqlite3  # 一次性：构建原生SQLite绑定\npnpm dev                    # 启动Next.js，访问 http://localhost:3737\n```\n\n首次请求会自动运行迁移并播种个人项目组合和通用项目。数据默认存储在~/.sdlc-portfolio-manager/data.sqlite（可通过SDLC_DATA_DIR覆盖）。\n\n测试使用vitest：\n\n```bash\npnpm test        # 单次运行\npnpm test:watch  # 监视模式\n```\n\n## 开发状态与路线图\n\n当前实现状态：\n\n| 章节 | 状态 |\n|------|------|\n| 1. Monorepo + 工具链 | ✅ 完成 |\n| 2. 数据库层（schema、迁移、认证） | ✅ 部分完成 —— 基础表已建立 |\n| 3. 项目组合 + 项目层次API | ✅ CRUD + 首次运行种子 + 健康检查端点 |\n| 4-21 | 跟踪于openspec/changes/initial-portfolio-manager/tasks.md |\n\n实现任务逐条跟踪于openspec/changes/initial-portfolio-manager/tasks.md。\n\n## 价值与启示\n\nsdlc-portfolio-manager代表了项目管理工具向AI原生演进的一个方向。它的核心价值在于：\n\n- **人机协作**：人类和AI Agent共享同一套工作项和状态\n- **资产化Agent能力**：将Agent行为视为可管理、可复用的资产\n- **本地优先**：数据主权归用户，无SaaS锁定\n- **规范驱动**：通过OpenSpec确保变更的可追溯性\n\n对于正在探索AI辅助开发工作流的团队，这是一个值得关注的参考实现。它展示了如何将传统项目管理的专业性与AI工作流的灵活性结合起来，创造真正的人机协作环境。
