staruhub/ClaudeSkills / skills/Geek-skills-keqian-method
keqian-method
Verified胥克谦式AI-Native产品开发方法论。适用于:(1) 使用AI Agent(Claude Code、Codex、Cursor等)进行产品级软件开发,(2) 设计和优化Harness/Skill体系,(3) 文档驱动开发(SDD)流程,(4) 构建自动化质量门禁和eval机制,(5) Token成本优化与缓存策略,(6) 产品人转型开发者的AI编程实践。触发场景包括"帮我设计开发流程"、"怎么降低token成本"、"怎么提高AI编码质量"、"文档驱动"、"质量门禁"、"harness设计"、"单agent vs multi-agent"、"自动化迭代"、"AI产品开发"、"SDD"、"eval机制"等。即使用户只是说"帮我用AI写代码"或"怎么让agent干活更靠谱"也应触发。注意:如果产品是行为开放、用户输入不可穷举的AI-native类型,请改用 xuefeng-method skill。不用于:单个bug修复或小改动(无需方法论)、PRD需求文档写作(用product-manager)。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.8 KB |
| evals/routing-evals.json | config | 1.8 KB |
| references/eval-patterns.md | markdown | 4.0 KB |
| references/sdd-framework.md | markdown | 2.7 KB |
references/sdd-framework.md
View on GitHub# SDD文档驱动开发框架
## 核心理念
不写文档 → 没有架构观 → AI只能盲干 → 质量不可控
文档不是给人看的附属品,而是给AI看的"操作手册"。
文档质量直接决定AI产出质量。
---
## 文档层次结构
```
Level 0: 产品愿景文档(Why)
├── 产品定位、目标用户、核心价值
└── 人工撰写,AI辅助优化
Level 1: PRD / 需求文档(What)
├── 功能列表、用户故事、验收标准
├── AI辅助撰写 + 人工深度审核
└── 每个功能点至少5个用例(不是3个敷衍)
Level 2: 技术架构文档(How)
├── 技术栈选择(模板化决策矩阵)
├── 模块划分、接口规范、数据模型
├── AI维护 + 人工把关
└── 变更时自动触发文档更新
Level 3: 实现指南(How exactly)
├── 编码规范、命名约定、目录结构
├── 直接嵌入repo(AGENTS.md / CLAUDE.md)
└── Agent直接读取执行
Level 4: 质量定义(How good)
├── Eval标准、门禁规则、threshold定义
├── 每个功能对应的验收脚本
└── 自动化执行,人工仲裁
```
---
## 文档 vs 代码的精力分配
| 阶段 | 文档 | 代码 | 说明 |
|------|------|------|------|
| 项目启动 | 90% | 10% | 几乎全部精力在文档 |
| 核心开发 | 60% | 40% | 持续维护文档 |
| 迭代收敛 | 40% | 60% | 文档趋于稳定 |
| 长期维护 | 70% | 30% | 文档是harness的核心 |
总体平均:**70%文档 / 30%代码**
---
## 技术栈选择模板
技术栈选择是套路化的事,不需要每次重新思考:
```markdown
### 决策矩阵
| 维度 | 选项A | 选项B | 选项C | 权重 |
|------|-------|-------|-------|------|
| 团队熟悉度 | | | | 30% |
| 社区生态 | | | | 20% |
| AI Agent友好度 | | | | 25% |
| 长期维护成本 | | | | 15% |
| 性能需求匹配 | | | | 10% |
注意:AI Agent友好度是新增维度,包括:
- 模型训练数据中该技术栈的覆盖度
- 代码补全/生成的准确率
- 调试信息的可读性
```
---
## 文档自动维护机制
```
代码变更 PR
↓
门禁检查:文档是否需要同步更新?
↓ 需要
自动生成文档更新PR
↓
人工审核文档更新
↓
合并
```
关键:让AI自己维护文档,代码再vibe对齐。
不要让文档和代码脱节,这是文档驱动的死穴。
---
## 文档门禁规则
1. **新增功能**:必须先有文档,再写代码
2. **技术栈变更**:必须更新决策矩阵
3. **接口变更**:必须同步更新接口文档
4. **架构变更**:必须更新架构图和决策记录
5. **质量标准变更**:必须更新eval定义
门禁不通过 → 不允许合并代码。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |