johnQ
c6ef6820e4
- scripts/scheduled-task.sh：daily/weekly/monthly 只做确定性动作，需模型判断的部分生成 queue 文件 - scripts/install-schedulers.sh：装成用户级 launchd（daily 07:20 / weekly 周一 10:00 / monthly 1 日 10:00） - .gitea issue/PR 模板：新技能提案走同一套 SCOPE 门槛问题 - README 一键部署 2 步 → 4 步；MAINTENANCE 增加定时任务一节与边界说明
ai-proj-helper — 让 Codex / Claude Code 变成你的项目经理
一套遵循 Agent Skills 标准的技能包 + MCP 服务，支持 Codex，并兼容 Claude Code。
它能帮你做什么
场景 1: 需求管理 — 从想法到上线
用自然语言描述需求，AI 会帮你讨论方案、生成 PRD、跟踪开发进度。
你：/req new 支持微信扫码登录
AI：好的，让我们先讨论方案。几个问题：
- 扫码后如何绑定已有账号？
- 先做哪个客户端？
你：绑定手机号，先做 Web
AI：方案已确认。正在生成 PRD... ✅ 已创建需求 REQ-042，PRD 文档已附加。
场景 2: AI 辅助编码 + 代码评审
需求确认后，AI 帮你分析代码库、拆分任务、编写代码，完成后自动进行五视角代码扫描。
你：/req dev REQ-042
AI：正在分析代码库结构... 已拆分为 3 个开发任务：
- 后端 - 微信 OAuth 接入
- 前端 - 扫码组件开发
- 数据库 - 用户绑定表设计
开始编码任务 1...
你：代码写完了，帮我 review
AI：/req cr 正在进行五视角代码扫描... ✅ 安全性、性能、可维护性、测试覆盖、规范合规 — 全部通过
场景 3: 思源笔记 + 飞书集成
PRD 文档存储在思源笔记中，可以导出发送到飞书群，通过飞书通知团队。
你：把 REQ-042 的 PRD 保存到思源笔记
AI：✅ 已保存到思源笔记「需求文档」目录下，标题：REQ-042 微信扫码登录。
你：把这篇笔记导出 PDF 发到飞书群
AI：✅ 已导出 PDF 并发送到飞书群「产品开发群」。
你：通知开发组
AI：✅ 已通过飞书通知「产品开发群」，包含需求摘要和笔记链接。
场景 4: 数据处理
用自然语言处理 Excel 数据，清洗、转换、导入看板。
你：读取 sales.xlsx，按月份汇总销售额，生成透视表
AI：✅ 已读取 1,234 条记录，按月份汇总完成。 透视表已保存到 sales_summary.xlsx。
开始使用
前置条件
- Codex（Skills 文档）或 Claude Code 已安装
- ai-proj 账号 + MCP API Key：联系管理员获取（Key 格式:
aiproj_pk_xxx）
一键部署（4 步搞定）
# 1. 克隆仓库
git clone https://gitea.pipexerp.com/pipexerp/ai-proj-helper.git
cd ai-proj-helper
# 2. 默认安装到 Codex 的用户级标准目录 ~/.agents/skills
./install-skills.sh
# 3. 装本地门禁（Gitea Actions 无 runner，commit/push 靠 git hook 兜底）
./scripts/install-git-hooks.sh
# 4. 装技能治理定时任务（macOS launchd：每日漂移检查 / 每周 evals 队列 / 每月审阅）
./scripts/install-schedulers.sh
第 3、4 步只对「本仓库的维护者」需要——只装技能给别人用的，跑完第 2 步就可以停。
安装器会复制完整技能目录，包括 SKILL.md、references、scripts 和 assets。Codex 会自动发现 ~/.agents/skills 中的技能；若没有出现，重启 Codex。
Claude Code 用户显式选择 Claude 目标；需要同时配置 MCP 和 marketplace 时运行 init.sh：
./install-skills.sh --agent claude
./init.sh --mode sse --token aiproj_pk_xxx
装完试试这些
"帮我创建一个任务: 修复登录页样式"
"/req new 用户注册支持邮箱验证"
"列出我今天的待办任务"
"帮我写一份商业计划书"
技能速查表
核心能力
| 技能 | 说明 | 典型用法 |
|---|---|---|
| ai-proj | 任务与需求管理 | "创建任务: 修复首页白屏" |
需求管理
| 技能 | 说明 | 典型用法 |
|---|---|---|
| req | 需求全生命周期管理 | /req new、/req list |
| req-prd | PRD 文档撰写 | /req prd REQ-001 |
| req-dev | 开发计划生成 | /req dev REQ-001 |
| req-test-gate | 测试与质量门禁 | /req test REQ-001 |
开发工具
| 技能 | 说明 | 典型用法 |
|---|---|---|
| dev-arch | 架构设计 | "设计用户中心的系统架构" |
| dev-coding | 编码实现 | "实现微信支付回调接口" |
| dev-test | 测试编写 | "为登录模块写单元测试" |
| pull-request | PR 管理 | /pr create、/pr review |
第三方集成
| 技能 | 说明 | 典型用法 |
|---|---|---|
| feishu | 飞书入口 | "同步任务到飞书" |
| feishu-bitable | 飞书多维表格 | "在多维表格中新增一行记录" |
| feishu-docx | 飞书云文档 | "创建飞书文档并写入 PRD" |
| wecom | 企业微信 | "通过企微群发送通知" |
| siyuan | 思源笔记 | "搜索笔记中的会议记录" |
| data-excel | Excel 数据处理 | "读取 Excel 并按月汇总" |
| doubao-voice | 豆包语音 | "把这段文字转成语音" |
商务工具
| 技能 | 说明 | 典型用法 |
|---|---|---|
| biz-plan | 商业计划书 | "写一份融资 BP" |
| biz-contract | 合同撰写 | "起草软件订阅合同" |
| biz-ops | 商务运营 | "制定运营推广方案" |
| finance | 财务对账 | "导入银行流水并对账" |
配置说明
claude-config.yaml
version: "1.0"
mcp:
mode: sse # sse（远程，推荐） | stdio（本地，需 Node.js）
skills:
disabled: [] # 禁用的技能列表，如 ["biz-ops-plugin"]
personal_dir: "skills-personal"
- mode: MCP 连接模式。
sse直连远程服务器（推荐），stdio在本地启动 Node.js 进程 - disabled: 不需要的技能可以加到这里，重新运行
./init.sh生效 - personal_dir: 本机个人技能目录，默认不被 Git 跟踪，也不会写入公开 marketplace
常见问题
Q: 运行 ./init.sh 报错 "API Key 不能为空"？
A: 需要先联系管理员获取 MCP API Key（格式 aiproj_pk_xxx），然后在提示处输入。
Q: 安装后 Codex 没有识别到技能？
A: 确认技能位于 ~/.agents/skills/<name>/SKILL.md，然后重启 Codex。Codex CLI 也可用 /skills 查看。
Q: 安装后 Claude Code 没有识别到技能？
A: 重启 Claude Code 后生效。如果仍不生效，检查 ~/.claude/plugins/known_marketplaces.json 中是否包含 ai-proj-helper 条目。
Q: 如何更新到最新版本？
A: 进入项目目录执行 git pull，然后运行 ./install-skills.sh；Claude Code 用户增加 --agent claude。
Q: 如何禁用不需要的技能？
A: 编辑 claude-config.yaml，在 disabled 列表中添加技能名（如 "doubao-voice-plugin"），然后运行 ./init.sh。
Q: SSE 和 stdio 模式有什么区别？
A: SSE 模式直连远程服务器，零依赖开箱即用（推荐）。stdio 模式在本地启动进程，需要 Node.js 环境和 mcp-task-bridge。
联系我们
- 管理员：Donglin Lai (qiudl)
- 邮箱：qiudl@zhiyuncai.com
- 仓库：https://gitea.pipexerp.com/pipexerp/ai-proj-helper
技能治理（2026-10-31 起）
- 真相源：本仓库。
~/.agents/skills、~/.claude/skills、$DSH_HOME/skills都只是安装产物。 - 收录门槛见 SCOPE.md：只收「真实失败 + 组合不出来」，被拒的想法记在
.out-of-scope/。 - 生命周期：
promoted（默认安装）/beta（需--include-beta）/deprecated（不安装）；新技能一律先进 beta。 - 调用模式：
model-invoked（占模型目录预算）vsuser-invoked（只由人触发，不占目录预算）。 - 安装：
- Codex：
./install-skills.sh --agent codex - DSH：
DSH_HOME=<path> ./install-skills.sh --agent dsh --link - Claude（兼容）：
./install-skills.sh --agent claude - 看漂移：
./install-skills.sh --audit
- Codex：
- 校验 / 安全 / 清单：
python3 scripts/validate-skills.py、./scripts/scan-skill.sh、python3 scripts/generate-catalog.py - 本地门禁（Gitea Actions 无 runner，用 git hook 兜底）：
./scripts/install-git-hooks.sh后，每次 commit 自动跑validate --strict+scan+catalog --check，push 前跑安装器测试。跳过单次：SKILL_GATE_SKIP=1。 - 项目级安装：
./install-skills.sh --agent codex --scope project --project-dir <项目根>→ 装到<项目根>/.agents/skills。 - 第三方技能风险扫描：
./scripts/scan-installed.sh（扫已装但非本仓库管理的技能）。 - 建技能：走
skill-creator技能（收录门槛、分桶、调用模式、evals、四段式文档、路由回改），不要手写。 - 路由表：
docs/skill-routing.md（什么任务用哪个技能，人读；由原ai-proj-helper-entry技能降级而来）。 - 维护节奏：
MAINTENANCE.md（每次改动 / 每日 / 每周 / 每月 / 每季度各做什么）。