pipexerp/ai-proj-helper
6
0
Fork 0
Code Issues Pull Requests 2 Actions Packages Projects Releases Wiki Activity
47 Commits 3 Branches 0 Tags
7eed2b8f106608eda793631958b3a37cfb4124e0
Commit Graph

47 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
John Qiu
7eed2b8f10 chore(marketplace): add karpathy-guidelines-plugin, update dev-coding/dev-review/review-checklist 
Karpathy 四原则融合到 req 技能工作流 (REQ-20260421-0003):
- dev-coding: 新增 Step 0「验证优先」(Goal-Driven Execution)
- dev-review: 五视角 → 六视角，新增 Scope 审计者 (Simplicity + Surgical)
- review-checklist/general: 新增 Karpathy 反模式速查表
- karpathy-guidelines-plugin: 新增独立插件，含四原则全文 + 与 req 工作流映射
 2026-04-21 10:08:18 +09:30
qiudl
5a45916b2c feat: devflow-claude P0/P1 集成 + VP 三件套强制规则 2026-04-20 23:51:03 +00:00
John Qiu
bcea648e3c merge: resolve conflict in req-prototype SKILL.md, keep iframe display rule from main 2026-04-21 09:20:55 +09:30
John Qiu
e3513f137b feat(req-prd): PRD 模板新增验收标准章节强制含 VP 三件套（REQ-20260421-0002） 
- 模板第7节新增「验收标准」章节，含 VP-Data/VP-Steps/VP-Pass 完整示例
- 检查清单「验收标准可测试」更新说明要求 VP 三件套
- 原第7节「风险评估」顺移为第8节

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-04-21 09:19:08 +09:30
John Qiu
011916ceb9 feat(req-review): 新增 VP 三件套强制检查（REQ-20260421-0002） 
- 结构检查表新增「VP 三件套」必须项
- 新增「VP 三件套强制检查」章节，含四项检查指标和驳回条件
- 常见驳回原因更新：验收不明包含 VP 缺失场景

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-04-21 09:17:11 +09:30
dongliang
48b792fb5a feat(req-prototype): 原型展示必须用 iframe，禁止图片方式 (REQ-20260420-0031) 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-04-21 01:07:10 +09:30
John Qiu
2ab0a61eb9 fix(install): handle nested skills/ subdirectory (e.g. dev-test) 
resolve_skills_src() detects when SKILL.md is one level deeper than skills/
and uses that subdirectory as rsync source instead.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-04-21 00:00:01 +09:30
John Qiu
de25f096e7 feat(sync): add install-skills.sh + install metadata to all 62 plugins 
- Add install_name, install_type, dir_category fields to all 62 plugin.json files
  to resolve name-mapping and skill-vs-command routing issues
- Add install-skills.sh: idempotent cross-machine skill sync script
  - Routes skill→~/.claude/skills/<name>/, command→~/.claude/commands/<name>.md
  - rsync full skills/ directory (preserves multi-file skills like dev-test, req-deploy)
  - State file ~/.claude/.installed-skills.json tracks installed versions
  - Conflict detection: warns before overwriting locally modified files
  - --dry-run, --category, --force, --cleanup, --list flags
- Add 9 new plugins migrated from local ~/.claude (agent-swarm, ai-chat,
  defect-analysis, executing-plans, finishing-branch, frontend-design,
  req-audit, req-lookback, req-retro)
- Add update-plugin-meta.py helper used to bulk-update plugin.json
- Fix siyuan SKILL.md: remove hardcoded server credentials, use env vars

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-04-20 23:55:26 +09:30
John Qiu
84d4e35a42 feat(req-prototype): 新增 HTML 上传模式，版本升至 v2.0.0 
- 添加 /req prototype upload 子命令（推荐模式）
- 含完整 curl 上传流程、HTML 设计规范及模板
- 更新错误处理与版本管理说明
- marketplace 更新（49 个插件）

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-04-20 18:06:32 +09:30
John Qiu
e5805cbb51 feat: P1-10/12/13/14 风险扫描 + 粒度判断 + Issue 集成 + PRD 校验 (REQ-20260416-0017) 
P1-10: pm-risk skill — 三维度风险扫描
  需求层: 停滞/草稿滞留/开发无提交/测试超期/批准未开发
  代码层: 未合并分支/频繁修复文件/提交频率下降
  流程层: 跳过评审/PR 无 review/测试门禁跳过/直接推 main
  三级风险: 🔴 严重 / 🟡 警告 / 🔵 提示

P1-12: req-prd 需求粒度 AI 判断
  创建前启发式检查：标题过宽建议拆分、过窄建议合并或改 task
  粒度参考表 + 已有需求扩展决策表 + 前后端拆分规则

P1-13: dev-commit issue 集成规范
  分支名 -iN 后缀传递 issue 编号
  commit message 自动追加 closes #N

P1-14: hooks/validate-prd.sh — PRD 章节校验
  PostToolUse hook 自动检查 10 个必需章节
  缺失时给出明确提示

marketplace: 48 → 49 plugins (新增 pm-risk-plugin)
 2026-04-19 13:33:26 +09:30
John Qiu
79c4e55719 feat: P1-8 客户场景章节 + P1-9 pm-ask skill (REQ-20260416-0017) 
P1-8: req-prd 模板增加 "1.4 客户原始诉求" 章节
  - 强制保留客户原话，不做 AI 加工转述
  - 标注提出人/时间/出处
  - 补充"客户原话原则"说明
  借鉴 devflow-claude requirement-template.md 的"1.3 客户场景"

P1-9: 新 skill pm-ask-plugin
  - 基于 ai-proj MCP + git log 真实数据的项目问答
  - 铁律：禁止编造，必须引用 REQ-XXX/commit-sha/文件路径
  - 数据不足时明确说明缺失
  - 区分事实和推测（⚠️ 推测：前缀）
  - 受众适配（高层/客户/内部/新人）
  借鉴 devflow-claude /pm:ask 命令

marketplace: 47 → 48 plugins
 2026-04-16 23:04:54 +09:30
John Qiu
23ea8fdca5 feat: 融合 devflow-claude P0 批机制 (REQ-20260416-0017) 
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 机制落地
 2026-04-16 21:02:29 +09:30
John Qiu
bfe3815626 fix(skill): 修复质量检查发现的引用问题 
- req-workflow: req-dev → req-design (2处)
- req-design: changelog 标注"原名 req-dev"
- marketplace.json 重新生成 (44→46 plugins)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-04-06 17:47:01 +09:30
John Qiu
3706d7f32d feat(skill): REQ-20260406-0004 技能三层分离重构（7主线+16插件） 
批次1: req-prd 瘦身 + req-design 重定位 + dev-coding 聚焦
批次2: dev-review 新建 + review-checklist 插件
批次3: dev-integration 新建 + req-compare 拆出
批次4: 插件完善 (req-research/db-migration/dev-scaffold/deploy-rollback)
批次5: 平台拆分 (dev-ios/dev-android/dev-mcp/dev-pda) + dev 分组更新
批次6: marketplace.json 32→44 plugins

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-04-06 17:44:08 +09:30
dongliang
31c2d5a474 feat(dev-deploy): SSH timeout + xcodegen cwd lessons (#11 #12) 2026-04-06 17:41:02 +09:30
dongliang
ccbdfd7eb3 feat(dev-cicd): docker exec health check + nginx mount lesson (#93 first green) 2026-04-06 13:49:15 +09:30
dongliang
f0e5735ffa feat(dev-cicd): CD deployment checklist + health check port mismatch lesson 2026-04-06 12:42:48 +09:30
dongliang
52b8c85b94 feat(dev-cicd): docker compose up --no-deps lesson 2026-04-06 11:53:38 +09:30
dongliang
0e24828a6d feat(dev-cicd): add docker compose pull scope + Docker Hub timeout lesson 2026-04-06 11:49:18 +09:30
dongliang
d564e6dbf9 feat(dev-cicd): add Docker context analysis + .dockerignore check 
从实际 CI 失败中学到的经验：
- 缺 .dockerignore 导致 768MB context 传入（node_modules）
- ACR push denied 因镜像路径缺 namespace
- /cicd analyze 增加 .dockerignore + 凭据硬编码 + 镜像命名扫描

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-04-06 11:43:21 +09:30
dongliang
a58dc39795 feat: add dev-cicd skill + enhance dev-deploy 
新增 dev-cicd（CI/CD 流水线设计/优化/排查）：
- Gitea Actions 模板（Go/iOS/Web/Docker）
- Pipeline 优化（浅克隆/缓存/并发取消）
- 故障排查决策树（20+ 常见错误）
- 安全检查清单 + Runner 管理

增强 dev-deploy（部署执行）：
- Docker Staging/Production 部署模板
- 部署前健康检查（证书/Docker/磁盘）
- 回滚策略（TestFlight/Docker/数据库）
- 部署监控（Feishu通知/ASC API）

技能总数: 28 (dev 分类: 7)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-04-06 11:10:13 +09:30
dongliang
b5f44ac6aa feat: add dev-deploy skill — iOS TestFlight deployment 
新增部署技能，含 iOS TestFlight 完整部署流程：
- SSH 远程构建 + 无签名 Archive + Export 签名上传
- ASC API 补全合规/测试说明/版本关联
- 10 个坑的经验教训总结
- 一键部署脚本模板 + 检查清单

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-04-06 09:46:23 +09:30
John Qiu
b6bd4bbfed feat(req): 新增 /req ci 命令 + dev→review quality_gate 门禁说明 
- req 技能新增 /req ci 命令规范（CI 检查与自动修复循环）
- 补充 dev→review 阶段 quality_gate 门禁说明
- req-workflow 流程概览增加 7.5 /req ci 步骤

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-31 13:19:55 +10:30
John Qiu
187f5621c9 feat(req): 部署门禁制度 — PDV 验收任务 + Deploy Gate 1-3 
在 /req deploy 流程中增加部署后 E2E 验收（Post-Deploy Verification）门禁：
- 新增 verification linkRole 和【验收】任务命名规范
- Deploy Gate 1 健康检查 / Gate 2 PDV 任务完成 / Gate 3 证据完整
- PDV Playwright spec 模板（页面可达、菜单可见、API 连通）
- 同步更新 req-workflow、dev-test、e2e-testing 相关文档

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-31 09:34:08 +10:30
John Qiu
b9c808cce0 feat(req-test-gate): 集成 Harness Engineering 工程约束方法论 
将项目级的 Ratchet/约定检测方法论融入 req-test-gate 技能，
通过 /req 流程三个节点自动触发（dev 环境检测、cr 约定建议、test Gate 0B），
无需手动记忆执行。

新增文档：harness-engineering.md、ratchet-pattern.md、convention-flow.md、
project-bootstrap.md 及 4 个模板（ratchet/convention 脚本、GATES.md、pre-commit）。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-26 11:34:42 +10:30
John Qiu
e3924e6b2b feat(skills): 新增 agent-browser 浏览器自动化技能 
基于 Vercel agent-browser CLI，支持网页交互、E2E 冒烟测试、需求验收验证、前端开发验证和截图对比。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-25 16:07:04 +10:30
John Qiu
22107fa7b8 feat(req): 集成 Stitch 原型设计到需求工作流 
新建 req-prototype 技能，支持基于 PRD 自动生成 Stitch UI 原型。
同步 req-review、req-workflow 技能到仓库，并更新 req、req-prd 中的
原型相关引用。

REQ-20260320-0005

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-20 23:42:24 +10:30
John Qiu
0724357ff4 feat(dev-test): 添加集成测试模板 + TG2 检测规则 
- 新增 templates/go-integration-test.md 集成测试代码骨架模板
- SKILL.md 增加 TG2 集成测试检测：跨 handlers/middleware/routes 变更自动触发

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-16 14:28:44 +10:30
John Qiu
2309e31e74 refactor(skills): 澄清 dev-test 与 req-test-gate 的职责边界 
- dev-test: 移除 "Gate 4" 编号，改用 "E2E 冒烟门禁"（避免与 req-test-gate 的 Gate 编号冲突）
- dev-test: 添加与 req-test-gate 的关系说明（本文档定义执行技术，门禁流程在 req-test-gate）
- req-test-gate: 2C 联调节新增无后端替代方案提示，引用 dev-test 的 API Mock 模式
- req-test-gate: Gate 5 前端回归贡献引用 dev-test 的 e2e-testing.md

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-16 11:40:47 +10:30
John Qiu
63ab37c256 feat(dev-test): 新增 API Mock E2E 冒烟测试模式，让 Gate 4 不再流于形式 
解决 E2E 门禁依赖后端导致形同虚设的问题：
- 新增 page.route() API Mock 模式，零后端依赖
- 文档化 mock JWT 生成、addInitScript 注入、catch-all 兜底等关键模式
- 整理 6 个常见陷阱及解决方案
- 明确 Gate 4 判定标准和适用场景

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-16 11:06:17 +10:30
John Qiu
58516a57a9 feat: add comprehensive MCP verification in init.sh 
Three-step verification after setup:
1. Server connection test (initialize → HTTP 200)
2. Tool registration test (tools/list → tool count)
3. Claude Code MCP test (claude mcp list → Connected)

Uses Mcp-Session-Id from initialize response for tools/list call.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-15 13:25:05 +10:30
John Qiu
185c4d0681 fix: detect claude CLI in common install paths 
command -v misses claude when not in PATH (e.g. brew install without
shell init). Now also checks /opt/homebrew/bin/claude and
/usr/local/bin/claude. Uses $CLAUDE_BIN variable for all invocations.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-15 13:17:14 +10:30
John Qiu
c303b534fc fix: update init.sh with lessons from MCP SSE debugging 
- Rename mode "sse" → "remote" (actual transport is Streamable HTTP)
- Fix .mcp.json fallback: "type": "sse" → "type": "http"
- Add post-install connection verification (curl initialize test)
- Accept "sse" as alias for backward compatibility

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-15 12:41:10 +10:30
John Qiu
3547db27d7 fix(init): use claude mcp add for new Claude Code, install skills to ~/.claude/skills/ 
- Detect claude CLI availability; if present, use `claude mcp add`
  with --transport http (Streamable HTTP) instead of writing .mcp.json
- Fall back to .mcp.json for environments without claude CLI
- Install skills directly to ~/.claude/skills/ (where Claude Code reads them)
- Remove marketplace/plugin registration (not used by Claude Code)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-15 00:26:24 +10:30
John Qiu
a17ac97906 docs: 重写 README 面向外部用户 + init.sh 增加技能市场自动注册 
README 从开发者内部文档风格改为面向小白用户的中文项目介绍，
增加场景演示、技能速查表、FAQ；init.sh 新增自动注册技能市场
到 known_marketplaces.json，实现真正的一键部署。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-14 16:21:26 +10:30
John Qiu
dcdae8c636 chore(marketplace): add publish-plugin, rewrite init.sh, cleanup obsolete plugins 
- Add publish-plugin: marketplace publish + Feishu bot notification
- Rewrite init.sh: SSE-first, fixed prod API, remove env selection
- Update CLAUDE.md, README.md, claude-config.yaml
- Update skills: req-plugin, req-prd-plugin, pull-request-plugin
- Delete sync-skills.sh (obsolete)
- Delete deprecated plugins: skills-ops/*, skills-projects/*, old skills-dev/req duplicates
- Regenerate marketplace.json (27 plugins)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-14 15:09:07 +10:30
John Qiu
5878c1f852 chore: 更新 marketplace.json，合并个人插件 dotfiles → qiudl-personal 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-14 11:54:07 +10:30
John Qiu
bb8f666108 refactor: 删除 session-plugin，Claude Code 已内置会话管理 
删除 skills-workflow/ 目录（已清空）。44 → 43 插件。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-14 11:51:46 +10:30
John Qiu
99a701d34d refactor: ai-proj-plugin 移至 skills-core，合并冗余 session 插件 
- ai-proj-plugin 作为 MCP 基础设施移入 skills-core/
- 删除 4 个冗余 session 子插件（save/reload/read/search），
  session-plugin 已包含全部功能
- 48 → 44 插件

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-14 11:50:11 +10:30
John Qiu
5ba8b21ad5 refactor: 删除已过时的 skill-manager-plugin 
功能已被 generate-marketplace.py、claude-config.yaml、sync-skills.sh 完全覆盖。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-14 11:33:49 +10:30
John Qiu
712063071c refactor: 通用技能按类别拆分为独立目录 
skills/ → skills-dev(9), skills-req(10), skills-ops(4),
skills-integration(8), skills-biz(4), skills-workflow(7)

generate-marketplace.py 改为自动扫描所有 skills-* 目录。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-14 11:31:58 +10:30
John Qiu
ea266e9cce refactor: 项目技能拆分到 skills-projects/ 
将 coolbuy (3) 和 enjoysa (2) 共 5 个项目特定技能从 skills/ 移至 skills-projects/，
保持通用技能与业务项目技能分离。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-14 11:21:53 +10:30
John Qiu
40b36a8e41 refactor: 将 dotfiles-plugin 移至 skills-personal 
个人化配置（私有 dotfiles 仓库、个人机器信息、个人路径），不适合公共技能目录。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-14 11:16:42 +10:30
John Qiu
99881e268a refactor: 合并 claude-marketplace，重构目录结构为单一仓库 
- 重命名 plugins/ → skills/，个人插件迁移到 skills-personal/（gitignore）
- 更新 generate-marketplace.py 支持 config 读取和 skills-personal 扫描
- 新增 claude-config.yaml（技能启用/禁用 + MCP 配置）
- 新增 init.sh（交互式 MCP 初始化，支持 stdio/SSE 模式）
- 新增 CLAUDE.md 项目说明
- 重写 README.md 反映新结构
- 删除过时脚本：PUSH.sh、generate-marketplace.sh、convert-skills.sh

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-14 11:11:59 +10:30
John Qiu
f7f5428812 feat(req): 代码评审增加五视角扫描法 
CR 从"Git diff + 检查清单"升级为结构化的五视角对抗性审查：
- 攻击者：跨租户泄露、越权、注入
- 泄露者：错误消息/日志/响应信息泄露
- 并发者：竞态、幂等、锁粒度
- 边界者：参数校验、类型溢出
- 依赖者：超时、降级、token 区分

每个视角配具体扫描 checklist，CR 报告模板增加五视角分节，
/req cr 流程从 1 行扩展为 8 步完整链路。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-14 08:12:41 +10:30
guoym
43585b8504 move claude-marketplace to ai-proj-helper 2026-03-12 21:42:30 +08:00
guoym
d7b6835e1d first commit 2026-03-12 21:41:15 +08:00