feat: 融合 devflow-claude P0 批机制 (REQ-20260416-0017) #1

qiudl · 2026-04-16T11:32:58Z

qiudl commented

2026-04-16 11:32:58 +00:00

摘要

融合 devflow-claude 的核心机制到 ai-proj-helper 体系。P0 批 6 项全部落地（其中 P0-3 Release 机制完整实现拆子任务延后，本 PR 含设计文档 + 最小可用脚本）。

P0 批交付物

P0-1: SessionStart Hook

hooks/session-context.sh: 从分支名解析 REQ-ID → 调 MCP API → 注入需求上下文
支持 ai-proj MCP 端点 /api/v1/mcp/requirements/by-display-id/

P0-2: PreToolUse Hook

hooks/pre-tool-confirm.sh: 拦截 10 类危险操作，弹原生确认
- 生产分支推送 / force push / tea pr merge --base main
- docker 生产容器 stop/rm / git reset --hard / git clean -f
- rm -rf 系统路径 / ssh 生产 + 破坏命令 / 生产库 DROP/TRUNCATE

P0-3: Release Draft 闸门（设计 + 最小可用脚本）

docs/design/release-draft-gate.md: 完整架构设计
- 流程对比 / 数据模型 / API 设计 / Gitea 集成 / 风险与应对
- 渐进式落地路径（P0-3.1 ~ P0-3.7）
hooks/release-draft.sh: 从本地 git 调 Gitea API 创建 draft release

P0-4: Memory 隔离规则

req-prd / req-design / req-workflow 三个 SKILL.md 新增 "Memory 隔离规则" 章节
明确禁止 auto-memory 污染模板产出物（章节结构、字段定义、生命周期文档）

P0-5: CLAUDE.md 架构检查 + 架构片段库

dev-coding SKILL.md 新增架构检查机制（非阻断警告）
templates/claude-md-snippets/:
- go-gin-gorm.md (ai-proj backend 风格)
- react-antd.md (ai-proj frontend 风格)
- vue-element.md (coolbuy-paas 风格)
- mcp-typescript.md (mcp-task-bridge 风格)
- generic.md (通用骨架)

P0-6: /commit 分支保护自动化

新 skill dev-commit-plugin
保护分支检测 → 自动建功能分支 → Conventional Commits → REQ-XXX 关联

其他

新增安装脚本 hooks/install.sh（自动合并到 ~/.claude/settings.json）
.claude-plugin/marketplace.json 重新生成，46 → 47 个 plugin

验证

bash hooks/install.sh 可安装成功
新会话切到 feat/REQ-xxx 分支后，SessionStart hook 注入需求上下文
尝试 git push origin main 会弹确认对话框
/commit 在 develop 分支自动建功能分支

后续拆分

P0-3 Release 机制完整实现拆 7 个子任务（见设计文档第 5 节），建议先部署 hooks 跑 1-2 周观察，再推进 Release 落地。

REQ-20260416-0017

## 摘要融合 devflow-claude 的核心机制到 ai-proj-helper 体系。P0 批 6 项全部落地（其中 P0-3 Release 机制完整实现拆子任务延后，本 PR 含设计文档 + 最小可用脚本）。 ## P0 批交付物 ### P0-1: SessionStart Hook - `hooks/session-context.sh`: 从分支名解析 REQ-ID → 调 MCP API → 注入需求上下文 - 支持 ai-proj MCP 端点 `/api/v1/mcp/requirements/by-display-id/` ### P0-2: PreToolUse Hook - `hooks/pre-tool-confirm.sh`: 拦截 10 类危险操作，弹原生确认 - 生产分支推送 / force push / tea pr merge --base main - docker 生产容器 stop/rm / git reset --hard / git clean -f - rm -rf 系统路径 / ssh 生产 + 破坏命令 / 生产库 DROP/TRUNCATE ### P0-3: Release Draft 闸门（设计 + 最小可用脚本） - `docs/design/release-draft-gate.md`: 完整架构设计 - 流程对比 / 数据模型 / API 设计 / Gitea 集成 / 风险与应对 - 渐进式落地路径（P0-3.1 ~ P0-3.7） - `hooks/release-draft.sh`: 从本地 git 调 Gitea API 创建 draft release ### P0-4: Memory 隔离规则 - req-prd / req-design / req-workflow 三个 SKILL.md 新增 "Memory 隔离规则" 章节 - 明确禁止 auto-memory 污染模板产出物（章节结构、字段定义、生命周期文档） ### P0-5: CLAUDE.md 架构检查 + 架构片段库 - dev-coding SKILL.md 新增架构检查机制（非阻断警告） - `templates/claude-md-snippets/`: - go-gin-gorm.md (ai-proj backend 风格) - react-antd.md (ai-proj frontend 风格) - vue-element.md (coolbuy-paas 风格) - mcp-typescript.md (mcp-task-bridge 风格) - generic.md (通用骨架) ### P0-6: /commit 分支保护自动化 - 新 skill `dev-commit-plugin` - 保护分支检测 → 自动建功能分支 → Conventional Commits → REQ-XXX 关联 ## 其他 - 新增安装脚本 `hooks/install.sh`（自动合并到 ~/.claude/settings.json） - `.claude-plugin/marketplace.json` 重新生成，46 → 47 个 plugin ## 验证 - [ ] `bash hooks/install.sh` 可安装成功 - [ ] 新会话切到 `feat/REQ-xxx` 分支后，SessionStart hook 注入需求上下文 - [ ] 尝试 `git push origin main` 会弹确认对话框 - [ ] `/commit` 在 develop 分支自动建功能分支 ## 后续拆分 P0-3 Release 机制完整实现拆 7 个子任务（见设计文档第 5 节），建议先部署 hooks 跑 1-2 周观察，再推进 Release 落地。 REQ-20260416-0017

qiudl added 1 commit 2026-04-16 11:32:58 +00:00

feat: 融合 devflow-claude P0 批机制 (REQ-20260416-0017) 23ea8fdca5

P0-1: SessionStart Hook — hooks/session-context.sh
  从分支名解析 REQ-ID，调 MCP API 查询需求详情注入 system-reminder

P0-2: PreToolUse Hook — hooks/pre-tool-confirm.sh
  拦截生产推送、force push、docker prod 容器操作、git reset --hard 等

P0-3: Release Draft 闸门设计文档 — docs/design/release-draft-gate.md
  完整架构 + 渐进式落地路径（拆 7 个子任务延后）
  附最小可用脚本 hooks/release-draft.sh 创建 Gitea draft release

P0-4: Memory 隔离规则 — 写入 req-prd / req-design / req-workflow
  禁止 auto-memory 污染模板产出物（章节结构、字段定义、文档结构）

P0-5: CLAUDE.md 架构检查 + 架构片段库
  dev-coding skill 执行前检查架构关键词
  新增 templates/claude-md-snippets/ 含 Go+Gin / React+AntD / Vue+Element /
  MCP+TS / generic 五套骨架

P0-6: /commit 分支保护自动化 — 新 skill dev-commit-plugin
  保护分支自动建功能分支 + Conventional Commits + REQ-XXX 自动关联

安装:
  bash hooks/install.sh

后续:
  P0-3 完整实现拆 7 个子任务（P0-3.1 ~ P0-3.7）
  建议先部署 hooks 跑 1-2 周观察，再推进 Release 机制落地

This branch is already included in the target branch. There is nothing to merge.

View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.

git fetch -u origin feat/devflow-integration-p0:feat/devflow-integration-p0

git checkout feat/devflow-integration-p0

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: pipexerp/ai-proj-helper#1