AGENT SKILL

ai-architect-lite

Lightweight playbook distilled from AI Architecture to keep dual-engine memory (.ai_context) and manifest dispatcher with minimal overhead; use when bootstrapping or porting the pattern into Claude Skills format.

License 许可
MIT
所属仓库
bg-szy/TOP-SKILLS
最近更新
2026-11-15
Stars
★ 6
Forks
0

01 前言 Front Matter

name
ai-architect-lite
description
Lightweight playbook distilled from AI Architecture to keep dual-engine memory (.ai_context) and manifest dispatcher with minimal overhead; use when bootstrapping or porting the pattern into Claude Skills format.

02 资源文件 6

03 SKILL.md 正文

AI Architect Lite

精简版「AI Architecture」:保留 .ai_context 记忆协议与 manifest 驱动调度,服务轻量项目或快速移植场景。

适用场景

  • 新建/迁移仓库,希望用最小开销引入 .ai_context + slash-first 调度。
  • 需要统一开发日志格式,但不启用完整 Pro 协议。
  • 想把 AI Architect 的初衷以 Claude Skill 形式交付,供其他会话直接加载。

快速上手

  1. 解析路径:PROJECT_ROOT = 当前仓库;TOOLKIT_PATH = 本技能所在目录(用于引用资源)。
  2. 检查 PROJECT_ROOT/.ai_context/03_ACTIVE_TASK.md;缺失则按 references/lite-protocol.md 模板创建或运行 python skills/project-init/entrypoint.py。
  3. 阅读 03_ACTIVE_TASK.md 获取 Current Mission;若存在 01/02 则作为补充规则加载,不强制解析全部细节。
  4. 查看 .ai-manifest.json:优先使用 commands 中的 slash 触发;若无 cognitive_skills 配置,则保持纯命令模式。
  • 新手护栏:若拿不准流程,先快速浏览 references/superpowers-lite.md,按其“迷你 TDD”“快速执行模板”走一遍。
  • 仅本技能加载时的默认动作:先输出友好欢迎语,告诉用户你已启用 AI Architect Lite,并给出 3 个可选下一步(如:① 生成迷你计划 python scripts/plan_helper.py ...;② 填写/创建 .ai_context/03_ACTIVE_TASK.md;③ 用 scripts/append_log.py 记录第一次动作)。

工作流程(Loop)

  • Dispatcher 次序:Slash > Intent(可选)> 普通对话;未命中技能时按当前任务回答。
  • 迷你流程(面向新手):用 3 步走完——① 写目标/约束/<=5 步计划(可直接在回答里列出,或运行 python scripts/plan_helper.py --goal \"...\" --steps \"...\" --validation \"...\" --out - 获取模板);② 先写“会失败”的验证点(命令或检查点),再动手;③ 完成后按验证点复跑并记录结果。
  • 日志写入:优先运行 python scripts/append_log.py --note "..." --action "..." --changes "..." --outcome "..." --next "..."(随技能提供的最小脚本,默认在项目根执行并自动创建 .ai_context/03_ACTIVE_TASK.md)。若项目已有通用 skills/memory-sync/entrypoint.py,可直接复用;两者都不可用时在 03_ACTIVE_TASK.md 手动追加四段式记录。
  • 范围与安全:仅操作 PROJECT_ROOT;执行前用中文说明修改/命令目的与影响,避免写入密钥。
  • 上下文收敛:长文档/规范放入 references/,按需加载;核心指令保持在本文件。

默认问候模板(仅单独加载本技能时使用)

嗨,我是 AI Architect Lite(目前只加载了我)。为了让你轻松上手,我们可以从这三步选一:
1) 想清楚要做什么:用“迷你计划”列出目标、3 步以内的行动、以及如何确认完成(好处:先定方向,少走弯路)。
2) 准备一本“任务笔记”:如果没有 .ai_context/03_ACTIVE_TASK.md,就按 references/lite-protocol.md 的格式建一个,记录当前任务和进展(好处:状态清晰,随时可查)。
3) 留下一条“开工日志”:用 scripts/append_log.py 记下你做的第一步和结果(好处:有迹可循,方便回顾或求助)。
告诉我你的目标,或者直接挑一条开始,我会陪你一步步完成。

资源使用

  • references/lite-protocol.md:.ai_context 最小规范、开发日志模板、slash-first 调度要点。
  • references/superpowers-lite.md:超能力精简卡,涵盖迷你 TDD、系统化调试和透明协作的最小做法。
  • scripts/append_log.py:为新手准备的最小日志脚本,自动建文件并按模板追加;可作为示例扩展。
  • scripts/plan_helper.py:生成目标/约束/步骤/验证的极简计划模板,默认输出到终端,避免额外文件。
  • assets/:保留占位,用于未来模板/示例;当前无需加载到上下文。

示例日志片段

### [2025-11-21 10:00] Action: 初始化 lite 协议
- Changes: 创建 .ai_context/03_ACTIVE_TASK.md;检查 .ai-manifest.json
- Outcome: 完成;未运行测试
- Next: 按当前任务执行并在每步后同步日志

04 同仓库更多 Skills

bg-szy
bg-szy/TOP-SKILLS

serpmaven

Scrape Google search results (SERP) to JSON with SERP Maven (serpmaven) - a real Chrome browser on a residential proxy with sticky sessions. Run it as a CLI, a Python library, a local HTTP search API (`serve`), an MCP server or a Docker image; set the proxy login, workers, pages and cost tracking. Use when the user wants Google results, rank tracking, a self-hosted SERP API, or live Google search for an AI agent.

★ 6
bg-szy
bg-szy/TOP-SKILLS

revnu-landing-page-audit

Find out why a landing page isn't turning visitors into signups, demos or sales. Audits one page against what the ad, post or search that sends people there promised, then checks the first screen, proof, call to action, friction and mobile. Returns at most 7 prioritized fixes, plus what is fine and what could not be checked; rewrites specific lines and fixes the page in the repo when asked. Never promises a conversion lift. Works without a Revnu account. Use when the user says or asks: "audit my landing page", "why isn't this page converting", "review my homepage", "my ads get clicks but no signups", "people bounce from the pricing page", "CRO review", "improve conversion rate", "is my hero section clear", "roast my landing page", "rewrite my headline", "what's wrong with this page", "landing page feedback", "make the signup page convert better". Not for SEO or AI-search audits, page speed engineering on its own, or building a new page from scratch.

★ 6
bg-szy
bg-szy/TOP-SKILLS

revnu-growth-context

Write down once who buys, what they're stuck on, what it costs, what proof you have and what you've already tried, so every growth task starts from facts instead of a questionnaire. Creates or updates .agents/revnu-growth.md from the repo, the live site and the user, and imports an existing product-marketing.md. Use when the user says "set up our marketing context", "who is our ideal customer", "write our ICP", "describe the product for marketing", "positioning doc", "what's our brand voice", "remember this about our customers", "log what we tried", "what have we learned from marketing", "we changed pricing, update the context", "update our growth notes", "summarize the business for the agent", "import my product-marketing.md", "start a growth doc", or before a first marketing, SEO, outreach or launch task when no context file exists. Works without a Revnu account.

★ 6
bg-szy
bg-szy/TOP-SKILLS

revnu-get-listed

Get onto the third-party pages AI answers and search cite when buyers ask for the best tool in your category: "best X" roundups, directories, review sites, GitHub awesome lists, community threads and comparison pages. Finds which ones are cited, ranks them by fit and effort, and drafts each submission, PR or pitch by the target's own rules. Use when the user says "get us listed", "which directories should we submit to", "how do we get into best-of lists", "why does ChatGPT recommend competitors and not us", "get mentioned in AI answers", "submit to awesome lists", "get on G2", "where are our competitors listed", "pitch listicle authors", "find backlink opportunities", "launch directories", "get into roundups", "Product Hunt alternatives", "where should we be listed", "get cited by Perplexity". Never submits, pays or posts without a yes. Works without a Revnu account.

★ 6
bg-szy
bg-szy/TOP-SKILLS

revnu-ai-readiness-audit

Audit whether your website gives ChatGPT, Perplexity, Claude, Gemini and Google's AI Overviews something worth quoting, and fix the pages that don't. Use when the user says or asks "is my site ready for AI search", "audit my site for AI answers", "AEO audit", "GEO audit", "why doesn't ChatGPT quote our pricing", "make our pages citable by AI", "do I need llms.txt", "does schema help with ChatGPT", "check our structured data", "is our content visible without JavaScript", "AI SEO audit", "optimize our homepage for AI answers", "LLM SEO check", "why does AI get our product wrong", "fix our site for AI Overviews". Checks fetchability and indexability, answers in the raw HTML, entity facts, schema (including JS-injected markup), headings, dates and llms.txt, then gives at most 10 prioritised fixes and edits the repo when asked. Works without a Revnu account.

★ 6
bg-szy
bg-szy/TOP-SKILLS

proxy-troubleshooting

Diagnose residential proxy failures, with NodeMaven's gateway as the reference - 407 with correct credentials, 406, 410, 500, a connection that hangs, ERR_TUNNEL_CONNECTION_FAILED in a browser, Playwright or Puppeteer ignoring proxy credentials, a sticky session that changes IP, geo-targeting that is silently ignored, passwords with special characters, and unexpected traffic from headless Chrome. Use when a proxy connection fails, returns the wrong location, or costs more traffic than expected.

★ 6