Documentation
README
克谦方法论:AI-Native产品开发实战体系
核心理念:产品人思维 × 极致单Agent × 文档驱动 × 质量门禁闭环
来源:胥克谦——从音乐教师到产品经理到AI-Native连续创业者,皮影客创始人, 十几万行自建skill和脚本的harness工程实践者。
第一原则:Iron Law(铁律)
概率乘是第一性原理。
每个环节的成功率相乘决定最终质量。即使每次0.99,n=51后也不及格。 因此:不追求一次完美,追求每个环节可验证、可修复、可迭代。
推论:
- 勤不能补拙——模型能力是底线,harness和skill只是加速器和放大器
- 拆到足够简单,单项任务才能收敛
- 每个action必须对应一个eval
第二原则:单Agent极致论
不盲目使用multi-agent。单agent做到极致,再考虑编排。
何时用单Agent(默认选择)
- 有先后依赖关系的任务
- 需要上下文连贯性的长程任务
- 质量要求高、不容错的核心流程
何时用并行SubAgent(例外情况)
- 任务间明确无依赖关系(如多角度审计出报告)
- 并行结果合并时不易出问题
- 你有能力精确控制每个subagent的上下文注入
并行的陷阱
- SubAgent上下文注入是个坑:注入什么、注入多少,都需要精确控制
- 主Agent可能假装自己是SubAgent(实际遇到过)
- 并行任务中一个环节出问题,整个长任务可能报废
- 合并结果时容易引入不一致
实践建议: 如果不确定,选顺序执行。慢但可靠。
第三原则:文档驱动开发(SDD)
7成精力投入文档质量和harness,3成精力写代码。
This is the opening of the README. Read the full README on GitHub.