docs(blueprint): agent-infrastructure 模块拆解为 5 张任务卡(planned)

/architect + 复查自洽完成,拆出 A-E 五张 S/M 卡:
框架扫描 → 三件套生成 → 腐化评分 → 确认UI → 看板指示器
This commit is contained in:
lanrtop 2026-06-29 18:02:57 +09:00
parent bdb43a2abf
commit 773f78a649
2 changed files with 32 additions and 16 deletions

View File

@ -6,7 +6,7 @@ description: >
成为每个项目的贴身导师。炼境本身亦被纳入其中, 成为每个项目的贴身导师。炼境本身亦被纳入其中,
形成可自我进化的开发智能闭环。 形成可自我进化的开发智能闭环。
iteration: 1 iteration: 1
updated: 2026-06-29 updated: 2026-06-30
@ -381,7 +381,7 @@ modules:
- id: agent-infrastructure - id: agent-infrastructure
name: Agent 友好基础设施生成 name: Agent 友好基础设施生成
area: backend area: backend
status: concept status: planned
progress: 0 progress: 0
position: [3750, 0] position: [3750, 0]

View File

@ -83,22 +83,38 @@
## 任务卡 ## 任务卡
> 本模块为 L 级,需先走 /architect 设计再拆分。以下为 concept 阶段的方向记录。 > /architect 已完成2026-06-29复查自洽后拆为以下 5 张可执行卡。
> 执行顺序A 和 C 可并行 → B依赖 A→ D依赖 A+B→ E依赖 C
### 💭 技术栈扫描与确认 UI ### 📋 A. 框架层扫描 + 契约路径推断
- status: concept - status: todo
- complexity: M
- files: src-tauri/src/commands/agent_infra.rs, src-tauri/src/commands/mod.rs, src-tauri/src/lib.rs, src/lib/commands.ts
- acceptance: `scan_agent_infra_stack(project_path, project_id)` 能从 package.jsonserde_json 解析 deps和 Cargo.toml字符串匹配识别 Drizzle/Prisma/Hono/Axum 等框架,返回带 confidence 的 DetectedContract 列表;有单元测试覆盖 drizzle/prisma/hono 识别
### 💭 project-context.yaml 生成器 ### 📋 B. 三件套文件生成
- status: concept - status: todo
- complexity: M
- depends: A
- files: src-tauri/src/commands/agent_infra.rs, src/lib/commands.ts
- acceptance: `generate_agent_infra_files(project_path, project_id, contracts)` 正确写入 `docs/ai-context/project-context.yaml`(含实际契约路径)、向 AGENTS.md 注入元规则段落(已有则跳过)、生成含项目特定 globs 的 `.claude/rules/doc-freshness.md`;对同一项目重复执行幂等
### 💭 AGENTS.md 元规则段落注入 ### 📋 C. 文档腐化评分
- status: concept - status: todo
- complexity: M
- files: src-tauri/src/commands/agent_infra.rs, src-tauri/src/db.rs, src/lib/commands.ts
- acceptance: `scan_doc_freshness(project_path, project_id)``silent_cmd("git").current_dir(project_path)` 读取契约路径 vs `docs/ai-context/project-context.yaml` 的最后 commit 时间戳project-context.yaml 不存在直接返回 RED结果写入 `doc_freshness_cache`migration 补齐);前端封装就绪
### 💭 .claude/rules/ 派生生成 ### 📋 D. 栈确认 UI + 生成按钮
- status: concept - status: todo
- complexity: M
- depends: A, B
- files: src/components/dashboard/AgentInfraPanel.tsx, src/components/dashboard/BlueprintModal.tsx
- acceptance: BlueprintModal 新增"Agent 基础设施"区块,展示 A 返回的检测结果(可编辑 contract 路径)、"生成三件套"按钮调用 B、展示写入结果written/skipped/failedUI 无类型错误
### 💭 腐化风险看板(文档新鲜度评分) ### 📋 E. 看板腐化指示器
- status: concept - status: todo
- complexity: S
### 💭 技术栈变更感知与重新生成提示 - depends: C
- status: concept - files: src/components/dashboard/ProjectCard.tsx, src/lib/commands.ts
- acceptance: ProjectCard 右上角显示腐化评分小圆点(🟢🟡🔴),读取 `doc_freshness_cache` 缓存(无缓存则不显示);不发起新的 git 扫描(仅读缓存)