bobo-ai-cli 1.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +216 -0
- package/dist/agent.d.ts +9 -0
- package/dist/agent.js +144 -0
- package/dist/agent.js.map +1 -0
- package/dist/config.d.ts +15 -0
- package/dist/config.js +76 -0
- package/dist/config.js.map +1 -0
- package/dist/index.d.ts +2 -0
- package/dist/index.js +366 -0
- package/dist/index.js.map +1 -0
- package/dist/knowledge-commands.d.ts +2 -0
- package/dist/knowledge-commands.js +40 -0
- package/dist/knowledge-commands.js.map +1 -0
- package/dist/knowledge.d.ts +17 -0
- package/dist/knowledge.js +112 -0
- package/dist/knowledge.js.map +1 -0
- package/dist/memory.d.ts +17 -0
- package/dist/memory.js +215 -0
- package/dist/memory.js.map +1 -0
- package/dist/planner.d.ts +22 -0
- package/dist/planner.js +130 -0
- package/dist/planner.js.map +1 -0
- package/dist/project.d.ts +25 -0
- package/dist/project.js +117 -0
- package/dist/project.js.map +1 -0
- package/dist/rules-commands.d.ts +2 -0
- package/dist/rules-commands.js +51 -0
- package/dist/rules-commands.js.map +1 -0
- package/dist/skills.d.ts +28 -0
- package/dist/skills.js +349 -0
- package/dist/skills.js.map +1 -0
- package/dist/structured/loader.d.ts +19 -0
- package/dist/structured/loader.js +147 -0
- package/dist/structured/loader.js.map +1 -0
- package/dist/structured/paths.d.ts +2 -0
- package/dist/structured/paths.js +14 -0
- package/dist/structured/paths.js.map +1 -0
- package/dist/structured/project-scaffold.d.ts +7 -0
- package/dist/structured/project-scaffold.js +60 -0
- package/dist/structured/project-scaffold.js.map +1 -0
- package/dist/structured/render-markdown.d.ts +37 -0
- package/dist/structured/render-markdown.js +47 -0
- package/dist/structured/render-markdown.js.map +1 -0
- package/dist/structured/render-table.d.ts +1 -0
- package/dist/structured/render-table.js +15 -0
- package/dist/structured/render-table.js.map +1 -0
- package/dist/structured/search.d.ts +10 -0
- package/dist/structured/search.js +104 -0
- package/dist/structured/search.js.map +1 -0
- package/dist/structured/skill-runner.d.ts +15 -0
- package/dist/structured/skill-runner.js +60 -0
- package/dist/structured/skill-runner.js.map +1 -0
- package/dist/structured/types.d.ts +212 -0
- package/dist/structured/types.js +97 -0
- package/dist/structured/types.js.map +1 -0
- package/dist/structured-skills-commands.d.ts +3 -0
- package/dist/structured-skills-commands.js +126 -0
- package/dist/structured-skills-commands.js.map +1 -0
- package/dist/structured-template-commands.d.ts +2 -0
- package/dist/structured-template-commands.js +34 -0
- package/dist/structured-template-commands.js.map +1 -0
- package/dist/tools/index.d.ts +3 -0
- package/dist/tools/index.js +450 -0
- package/dist/tools/index.js.map +1 -0
- package/dist/ui.d.ts +19 -0
- package/dist/ui.js +72 -0
- package/dist/ui.js.map +1 -0
- package/dist/web.d.ts +4 -0
- package/dist/web.js +124 -0
- package/dist/web.js.map +1 -0
- package/knowledge/advanced-patterns.md +70 -0
- package/knowledge/agent-directives.md +74 -0
- package/knowledge/dream.md +36 -0
- package/knowledge/engineering.md +46 -0
- package/knowledge/error-catalog.md +33 -0
- package/knowledge/index.json +170 -0
- package/knowledge/memory/cache-optimization-and-skill-integration.md +102 -0
- package/knowledge/memory/engineering-patterns.md +134 -0
- package/knowledge/memory/feedback_root_structure.md +16 -0
- package/knowledge/memory/project-contexts.md +69 -0
- package/knowledge/memory/tools-and-services.md +85 -0
- package/knowledge/rules/agents.md +62 -0
- package/knowledge/rules/blocking-rules.md +323 -0
- package/knowledge/rules/cache-management.md +379 -0
- package/knowledge/rules/capability-evolution.md +132 -0
- package/knowledge/rules/coding.md +126 -0
- package/knowledge/rules/engineering-workflows.md +225 -0
- package/knowledge/rules/evomap-content-guidelines.md +354 -0
- package/knowledge/rules/evomap-guide.md +224 -0
- package/knowledge/rules/git.md +31 -0
- package/knowledge/rules/hooks.md +106 -0
- package/knowledge/rules/performance.md +101 -0
- package/knowledge/rules/remotion-auto-production.md +1120 -0
- package/knowledge/rules/security.md +46 -0
- package/knowledge/rules/testing.md +32 -0
- package/knowledge/rules/work-mode.md +208 -0
- package/knowledge/rules.md +62 -0
- package/knowledge/skills/Skill_Seekers.md +1722 -0
- package/knowledge/skills/ab-test-setup.md +557 -0
- package/knowledge/skills/agent-sdk-dev.md +238 -0
- package/knowledge/skills/agent-tools.md +136 -0
- package/knowledge/skills/analytics-tracking.md +597 -0
- package/knowledge/skills/artifacts-builder.md +89 -0
- package/knowledge/skills/asana.md +13 -0
- package/knowledge/skills/backend-expert.md +97 -0
- package/knowledge/skills/brand-voice.md +481 -0
- package/knowledge/skills/browser-use.md +419 -0
- package/knowledge/skills/cache-optimization-skill.md +179 -0
- package/knowledge/skills/canvas-design.md +147 -0
- package/knowledge/skills/citation-validator.md +203 -0
- package/knowledge/skills/clangd-lsp.md +52 -0
- package/knowledge/skills/code-review-expert.md +85 -0
- package/knowledge/skills/code-review.md +280 -0
- package/knowledge/skills/code-simplifier.md +13 -0
- package/knowledge/skills/commit-commands.md +258 -0
- package/knowledge/skills/competitor-alternatives.md +795 -0
- package/knowledge/skills/content-atomizer.md +910 -0
- package/knowledge/skills/content-research-writer.md +605 -0
- package/knowledge/skills/context-optimization-suite.md +162 -0
- package/knowledge/skills/context7.md +13 -0
- package/knowledge/skills/copy-editing.md +494 -0
- package/knowledge/skills/copywriting.md +510 -0
- package/knowledge/skills/csharp-lsp.md +40 -0
- package/knowledge/skills/decision-making-framework.md +154 -0
- package/knowledge/skills/developer-growth-analysis.md +335 -0
- package/knowledge/skills/direct-response-copy.md +2336 -0
- package/knowledge/skills/docker-expert.md +229 -0
- package/knowledge/skills/document-skills.md +13 -0
- package/knowledge/skills/documentation-expert.md +126 -0
- package/knowledge/skills/email-sequence.md +1061 -0
- package/knowledge/skills/email-sequences.md +910 -0
- package/knowledge/skills/example-plugin.md +72 -0
- package/knowledge/skills/explanatory-output-style.md +82 -0
- package/knowledge/skills/feature-dev.md +458 -0
- package/knowledge/skills/file-organizer.md +466 -0
- package/knowledge/skills/firebase.disabled.md +13 -0
- package/knowledge/skills/form-cro.md +488 -0
- package/knowledge/skills/free-tool-strategy.md +636 -0
- package/knowledge/skills/frontend-design-offical.md +55 -0
- package/knowledge/skills/frontend-design.md +41 -0
- package/knowledge/skills/frontend-expert.md +93 -0
- package/knowledge/skills/github.md +13 -0
- package/knowledge/skills/gitlab.md +13 -0
- package/knowledge/skills/gopls-lsp.md +32 -0
- package/knowledge/skills/got-controller.md +218 -0
- package/knowledge/skills/greptile.md +72 -0
- package/knowledge/skills/hookify.md +376 -0
- package/knowledge/skills/image-editor.md +189 -0
- package/knowledge/skills/image-enhancer.md +109 -0
- package/knowledge/skills/jdtls-lsp.md +49 -0
- package/knowledge/skills/json-canvas.md +654 -0
- package/knowledge/skills/keyword-research.md +559 -0
- package/knowledge/skills/kotlin-lsp.md +28 -0
- package/knowledge/skills/laravel-boost.md +13 -0
- package/knowledge/skills/launch-strategy.md +394 -0
- package/knowledge/skills/lead-magnet.md +393 -0
- package/knowledge/skills/learning-output-style.md +106 -0
- package/knowledge/skills/linear.md +13 -0
- package/knowledge/skills/lua-lsp.md +47 -0
- package/knowledge/skills/marketing-ideas.md +720 -0
- package/knowledge/skills/marketing-psychology.md +534 -0
- package/knowledge/skills/mcp-builder.md +369 -0
- package/knowledge/skills/meeting-insights-analyzer.md +347 -0
- package/knowledge/skills/memory-evolution-system.md +172 -0
- package/knowledge/skills/multi-lens-thinking.md +407 -0
- package/knowledge/skills/nano-banana-pro.md +116 -0
- package/knowledge/skills/newsletter.md +736 -0
- package/knowledge/skills/notebooklm.md +296 -0
- package/knowledge/skills/obsidian-bases.md +634 -0
- package/knowledge/skills/obsidian-markdown.md +651 -0
- package/knowledge/skills/onboarding-cro.md +494 -0
- package/knowledge/skills/orchestrator.md +681 -0
- package/knowledge/skills/page-cro.md +379 -0
- package/knowledge/skills/paid-ads.md +624 -0
- package/knowledge/skills/paywall-upgrade-cro.md +651 -0
- package/knowledge/skills/php-lsp.md +36 -0
- package/knowledge/skills/planning-with-files.md +193 -0
- package/knowledge/skills/playwright.md +13 -0
- package/knowledge/skills/plugin-dev.md +434 -0
- package/knowledge/skills/popup-cro.md +520 -0
- package/knowledge/skills/positioning-angles.md +330 -0
- package/knowledge/skills/pr-review-toolkit.md +359 -0
- package/knowledge/skills/pricing-strategy.md +777 -0
- package/knowledge/skills/programmatic-seo.md +714 -0
- package/knowledge/skills/pyright-lsp.md +43 -0
- package/knowledge/skills/quality-assurance-framework.md +168 -0
- package/knowledge/skills/question-refiner.md +160 -0
- package/knowledge/skills/ralph-loop.md +205 -0
- package/knowledge/skills/refactoring-expert.md +103 -0
- package/knowledge/skills/referral-program.md +668 -0
- package/knowledge/skills/research-executor.md +164 -0
- package/knowledge/skills/review-with-security.md +12 -0
- package/knowledge/skills/rust-analyzer-lsp.md +50 -0
- package/knowledge/skills/schema-markup.md +647 -0
- package/knowledge/skills/security-audit-expert.md +124 -0
- package/knowledge/skills/security-expert.md +140 -0
- package/knowledge/skills/security-guidance.md +13 -0
- package/knowledge/skills/seedance-prompt.md +139 -0
- package/knowledge/skills/self-evolution.md +1160 -0
- package/knowledge/skills/seo-audit.md +432 -0
- package/knowledge/skills/seo-content.md +787 -0
- package/knowledge/skills/serena.md +13 -0
- package/knowledge/skills/signup-flow-cro.md +409 -0
- package/knowledge/skills/skill-creator.md +220 -0
- package/knowledge/skills/skill-manager.md +226 -0
- package/knowledge/skills/skill-share.md +98 -0
- package/knowledge/skills/slack.md +13 -0
- package/knowledge/skills/social-content.md +878 -0
- package/knowledge/skills/spec-flow-skill.md +124 -0
- package/knowledge/skills/stripe.md +13 -0
- package/knowledge/skills/supabase.md +13 -0
- package/knowledge/skills/swift-lsp.md +40 -0
- package/knowledge/skills/synthesizer.md +236 -0
- package/knowledge/skills/template-skill.md +16 -0
- package/knowledge/skills/testing-expert.md +99 -0
- package/knowledge/skills/theme-factory.md +72 -0
- package/knowledge/skills/tiktok-research.md +208 -0
- package/knowledge/skills/typescript-lsp.md +36 -0
- package/knowledge/skills/ui-ux-pro-max.md +247 -0
- package/knowledge/skills/verify.md +15 -0
- package/knowledge/skills/visual-prompt-engineer.md +102 -0
- package/knowledge/skills/webapp-testing.md +111 -0
- package/knowledge/skills/wide-research.md +191 -0
- package/knowledge/system.md +93 -0
- package/knowledge/task-router.md +37 -0
- package/knowledge/verification.md +38 -0
- package/knowledge/workflows/3d-viz.md +47 -0
- package/knowledge/workflows/data-pipeline.md +47 -0
- package/knowledge/workflows/db-migration.md +51 -0
- package/knowledge/workflows/feature-dev.md +41 -0
- package/knowledge/workflows/tdd-flow.md +52 -0
- package/knowledge/workflows/ui-verify.md +51 -0
- package/package.json +60 -0
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
---
|
|
2
|
+
id: "security"
|
|
3
|
+
title: "Security Guidelines"
|
|
4
|
+
category: "domain"
|
|
5
|
+
tags: ["security guidelines", "mandatory security checks", "secret management", "security response protocol"]
|
|
6
|
+
source: "C:/Users/Administrator/.claude/rules/domain/security.md"
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Security Guidelines
|
|
10
|
+
|
|
11
|
+
## Mandatory Security Checks
|
|
12
|
+
|
|
13
|
+
Before ANY commit:
|
|
14
|
+
|
|
15
|
+
- [ ] No hardcoded secrets (API keys, passwords, tokens)
|
|
16
|
+
- [ ] All user inputs validated
|
|
17
|
+
- [ ] SQL injection prevention (parameterized queries)
|
|
18
|
+
- [ ] XSS prevention (sanitized HTML)
|
|
19
|
+
- [ ] CSRF protection enabled
|
|
20
|
+
- [ ] Authentication/authorization verified
|
|
21
|
+
- [ ] Rate limiting on all endpoints
|
|
22
|
+
- [ ] Error messages don't leak sensitive data
|
|
23
|
+
|
|
24
|
+
## Secret Management
|
|
25
|
+
|
|
26
|
+
```typescript
|
|
27
|
+
// NEVER: Hardcoded secrets
|
|
28
|
+
const apiKey = 'sk-proj-xxxxx';
|
|
29
|
+
|
|
30
|
+
// ALWAYS: Environment variables
|
|
31
|
+
const apiKey = process.env.OPENAI_API_KEY;
|
|
32
|
+
|
|
33
|
+
if (!apiKey) {
|
|
34
|
+
throw new Error('OPENAI_API_KEY not configured');
|
|
35
|
+
}
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
## Security Response Protocol
|
|
39
|
+
|
|
40
|
+
If security issue found:
|
|
41
|
+
|
|
42
|
+
1. STOP immediately
|
|
43
|
+
2. Use **security-reviewer** agent
|
|
44
|
+
3. Fix CRITICAL issues before continuing
|
|
45
|
+
4. Rotate any exposed secrets
|
|
46
|
+
5. Review entire codebase for similar issues
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
---
|
|
2
|
+
id: "testing"
|
|
3
|
+
title: "Testing Requirements"
|
|
4
|
+
category: "domain"
|
|
5
|
+
tags: ["testing requirements", "standards", "tdd checklist", "troubleshooting", "agents"]
|
|
6
|
+
source: "C:/Users/Administrator/.claude/rules/domain/testing.md"
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Testing Requirements
|
|
10
|
+
|
|
11
|
+
> Quick reference. Full TDD workflow → `engineering-workflows.md` Phase 2.1
|
|
12
|
+
|
|
13
|
+
## Standards
|
|
14
|
+
- **Coverage**: ≥ 80%
|
|
15
|
+
- **Types**: Unit + Integration + E2E (Playwright)
|
|
16
|
+
- **Approach**: TDD mandatory (RED → GREEN → REFACTOR)
|
|
17
|
+
|
|
18
|
+
## TDD Checklist
|
|
19
|
+
1. Write test first → must FAIL
|
|
20
|
+
2. Write minimal implementation → must PASS
|
|
21
|
+
3. Refactor → keep passing
|
|
22
|
+
4. Property tests for critical paths
|
|
23
|
+
5. Verify coverage ≥ 80%
|
|
24
|
+
|
|
25
|
+
## Troubleshooting
|
|
26
|
+
1. Check test isolation (no shared state)
|
|
27
|
+
2. Verify mocks match real interfaces
|
|
28
|
+
3. Fix implementation, not tests (unless tests are wrong)
|
|
29
|
+
|
|
30
|
+
## Agents
|
|
31
|
+
- **tdd-guide**: New features, enforces write-tests-first
|
|
32
|
+
- **e2e-runner**: Playwright E2E specialist
|
|
@@ -0,0 +1,208 @@
|
|
|
1
|
+
---
|
|
2
|
+
id: "work-mode"
|
|
3
|
+
title: "核心工作模式"
|
|
4
|
+
category: "core"
|
|
5
|
+
tags: ["核心工作模式", "🎯 四步工作流", "🔄 长任务的阶段门控", "📁 三文件模式(长任务必用)", "⚠️ 失败追踪", "errors encountered"]
|
|
6
|
+
source: "E:/Bobo's Coding cache/.claude/rules/core/work-mode.md"
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# 核心工作模式
|
|
10
|
+
|
|
11
|
+
> **原则**: 计划 → 确认 → 执行到底 → 验收
|
|
12
|
+
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
## 🎯 四步工作流
|
|
16
|
+
|
|
17
|
+
```
|
|
18
|
+
1️⃣ 收到任务
|
|
19
|
+
↓ 创建 TodoList 规划
|
|
20
|
+
2️⃣ 展示计划
|
|
21
|
+
↓ 等待用户确认
|
|
22
|
+
3️⃣ 执行到底(不问问题)
|
|
23
|
+
↓ 完成所有任务
|
|
24
|
+
4️⃣ 总结验收
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
---
|
|
28
|
+
|
|
29
|
+
## ✅ Step 1: 收到任务 → 规划
|
|
30
|
+
|
|
31
|
+
### 自动创建 TodoList
|
|
32
|
+
|
|
33
|
+
使用 `TaskCreate` 工具记录任务:
|
|
34
|
+
|
|
35
|
+
```markdown
|
|
36
|
+
- [ ] 理解需求
|
|
37
|
+
- [ ] 设计方案
|
|
38
|
+
- [ ] 实现功能
|
|
39
|
+
- [ ] 测试验证
|
|
40
|
+
- [ ] 总结文档
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
### 何时需要规划?
|
|
44
|
+
|
|
45
|
+
- **需要**: 3+ 步骤的非平凡任务
|
|
46
|
+
- **不需要**: 单一、直接的简单任务
|
|
47
|
+
|
|
48
|
+
---
|
|
49
|
+
|
|
50
|
+
## 📋 Step 2: 展示计划 → 等待确认
|
|
51
|
+
|
|
52
|
+
### 展示内容
|
|
53
|
+
|
|
54
|
+
1. **任务分解**: 具体步骤列表
|
|
55
|
+
2. **预估难度**: 简单/中等/复杂
|
|
56
|
+
3. **潜在风险**: 如果有的话
|
|
57
|
+
4. **所需工具**: 使用什么技术/工具
|
|
58
|
+
|
|
59
|
+
### 等待明确确认
|
|
60
|
+
|
|
61
|
+
**继续的信号**:
|
|
62
|
+
|
|
63
|
+
- "好的"
|
|
64
|
+
- "开始吧"
|
|
65
|
+
- "继续"
|
|
66
|
+
- "ready"
|
|
67
|
+
|
|
68
|
+
**暂停的信号**:
|
|
69
|
+
|
|
70
|
+
- "等等"
|
|
71
|
+
- "先不要"
|
|
72
|
+
- "让我想想"
|
|
73
|
+
|
|
74
|
+
---
|
|
75
|
+
|
|
76
|
+
## 🚀 Step 3: 执行到底(不问问题)
|
|
77
|
+
|
|
78
|
+
### 核心原则
|
|
79
|
+
|
|
80
|
+
**不问问题,自行决策**
|
|
81
|
+
|
|
82
|
+
除非遇到 **4种致命阻塞**(见 `blocking-rules.md`),否则自行决策并执行。
|
|
83
|
+
|
|
84
|
+
### 自行决策的事项
|
|
85
|
+
|
|
86
|
+
✅ 文件命名
|
|
87
|
+
✅ 代码风格
|
|
88
|
+
✅ 依赖版本
|
|
89
|
+
✅ 测试策略
|
|
90
|
+
✅ UI 细节
|
|
91
|
+
✅ 函数命名
|
|
92
|
+
✅ 目录结构
|
|
93
|
+
✅ 注释风格
|
|
94
|
+
|
|
95
|
+
**遵循原则**: 现有规范 > 最佳实践 > 常见约定
|
|
96
|
+
|
|
97
|
+
### 执行期间
|
|
98
|
+
|
|
99
|
+
- **更新 TodoList**: 完成一项 → 标记完成
|
|
100
|
+
- **记录问题**: 遇到问题 → 记录到 notes.md
|
|
101
|
+
- **保持专注**: 不偏离原计划
|
|
102
|
+
|
|
103
|
+
---
|
|
104
|
+
|
|
105
|
+
## 📝 Step 4: 总结验收
|
|
106
|
+
|
|
107
|
+
### 总结内容
|
|
108
|
+
|
|
109
|
+
1. **完成情况**: 哪些做了,哪些没做
|
|
110
|
+
2. **遇到的问题**: 关键决策点
|
|
111
|
+
3. **重要发现**: 值得记录的经验
|
|
112
|
+
4. **后续建议**: 如果有的话
|
|
113
|
+
|
|
114
|
+
### 验收标准
|
|
115
|
+
|
|
116
|
+
- [ ] 所有 TodoList 项目完成
|
|
117
|
+
- [ ] 代码可以运行
|
|
118
|
+
- [ ] 测试通过
|
|
119
|
+
- [ ] 文档更新(如需要)
|
|
120
|
+
|
|
121
|
+
---
|
|
122
|
+
|
|
123
|
+
## 🔄 长任务的阶段门控
|
|
124
|
+
|
|
125
|
+
对于大型任务(>1小时),可以分阶段执行:
|
|
126
|
+
|
|
127
|
+
```
|
|
128
|
+
Phase 1: 需求理解
|
|
129
|
+
↓ [用户确认 "ready"]
|
|
130
|
+
Phase 2: 设计方案
|
|
131
|
+
↓ [用户确认 "ready"]
|
|
132
|
+
Phase 3: 实现代码
|
|
133
|
+
↓ [用户确认 "ready"]
|
|
134
|
+
Phase 4: 测试验证
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
### 阶段门控原则
|
|
138
|
+
|
|
139
|
+
**永远不进入下一阶段,直到用户明确确认。**
|
|
140
|
+
|
|
141
|
+
---
|
|
142
|
+
|
|
143
|
+
## 📁 三文件模式(长任务必用)
|
|
144
|
+
|
|
145
|
+
长任务(>30分钟)使用三文件模式:
|
|
146
|
+
|
|
147
|
+
```
|
|
148
|
+
task_plan.md - 任务规划和进度追踪
|
|
149
|
+
notes.md - 研究笔记和发现记录
|
|
150
|
+
[deliverable].md - 最终产出物
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
### 关键机制
|
|
154
|
+
|
|
155
|
+
**每个重要决策点前,重新读取 task_plan.md**
|
|
156
|
+
|
|
157
|
+
防止目标漂移,刷新注意力窗口。
|
|
158
|
+
|
|
159
|
+
---
|
|
160
|
+
|
|
161
|
+
## ⚠️ 失败追踪
|
|
162
|
+
|
|
163
|
+
记录所有失败,避免重复错误:
|
|
164
|
+
|
|
165
|
+
```markdown
|
|
166
|
+
## Errors Encountered
|
|
167
|
+
|
|
168
|
+
### [时间] 错误类型
|
|
169
|
+
|
|
170
|
+
**Error**: 具体错误信息
|
|
171
|
+
**Root Cause**: 根本原因
|
|
172
|
+
**Solution**: 解决方案
|
|
173
|
+
**Learning**: 经验教训
|
|
174
|
+
```
|
|
175
|
+
|
|
176
|
+
---
|
|
177
|
+
|
|
178
|
+
## 🎯 成功的工作模式
|
|
179
|
+
|
|
180
|
+
```
|
|
181
|
+
收到任务
|
|
182
|
+
↓
|
|
183
|
+
快速规划(TodoList)
|
|
184
|
+
↓
|
|
185
|
+
展示 + 等待确认
|
|
186
|
+
↓
|
|
187
|
+
执行到底(自行决策)
|
|
188
|
+
↓
|
|
189
|
+
总结验收(交付成果)
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
**不是**:
|
|
193
|
+
|
|
194
|
+
```
|
|
195
|
+
收到任务
|
|
196
|
+
↓
|
|
197
|
+
问一堆问题
|
|
198
|
+
↓
|
|
199
|
+
再问更多问题
|
|
200
|
+
↓
|
|
201
|
+
还在问问题...
|
|
202
|
+
```
|
|
203
|
+
|
|
204
|
+
---
|
|
205
|
+
|
|
206
|
+
**版本**: v1.0
|
|
207
|
+
**来源**: CLAUDE.md v4.2 核心原则
|
|
208
|
+
**状态**: Active
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
# 工作规则
|
|
2
|
+
|
|
3
|
+
## 决策原则
|
|
4
|
+
- 95% 的决策自行处理,不问用户
|
|
5
|
+
- 能自己查到的不问,能自己试的不猜
|
|
6
|
+
- 遇到问题先搜索/读源码/试方案,不被动等指示
|
|
7
|
+
- 失败后自动重试不同方案(至少 3 种),才升级找人
|
|
8
|
+
|
|
9
|
+
## 代码规范(零注释原则)
|
|
10
|
+
- 默认不写注释。只在 WHY 非显而易见时写(隐藏约束/bug workaround/会让人惊讶的行为)
|
|
11
|
+
- 好的命名已说明 WHAT,不用注释重复
|
|
12
|
+
- 禁止 "added for issue #123" / "used by X flow"(属于 PR 描述)
|
|
13
|
+
- 不删别人注释:除非删了对应代码或确认注释错误
|
|
14
|
+
- 不投机抽象:三行重复好过一个过早抽象。只做任务实际需要的复杂度
|
|
15
|
+
- 不加没用的:不加 impossible error handling、feature flags、backward compat shims
|
|
16
|
+
|
|
17
|
+
## 诚实报告(硬性规则)
|
|
18
|
+
- ❌ 不许假装"所有测试通过"(测试失败就说失败)
|
|
19
|
+
- ❌ 不许隐瞒/简化失败结果来伪造绿灯
|
|
20
|
+
- ❌ 不许把未完成/有问题的工作说成"已完成"
|
|
21
|
+
- ✅ 检查通过就说通过,不加没必要的免责声明
|
|
22
|
+
- ✅ 没法验证就明确说"我没有运行验证"
|
|
23
|
+
- **准确的报告,不是防御性的报告**
|
|
24
|
+
|
|
25
|
+
## 验证后才算完成
|
|
26
|
+
- 完成非平凡任务后**必须验证**:跑测试、执行脚本、检查输出
|
|
27
|
+
- 最小复杂度 ≠ 跳过终点线
|
|
28
|
+
- 无法验证时明确说明,不假装成功
|
|
29
|
+
|
|
30
|
+
## Git 规范
|
|
31
|
+
- rebase 后必须 review diff:`git diff HEAD~1` 确认完整性(rebase 会静默丢代码)
|
|
32
|
+
- commit message 简洁明了,英文,动词开头
|
|
33
|
+
- push 前确认 build 通过
|
|
34
|
+
- 一个 PR 一个功能,不混杂
|
|
35
|
+
|
|
36
|
+
## ⚠️ 实战经验教训(纠正记录精华)
|
|
37
|
+
|
|
38
|
+
### API 分页必须拉全
|
|
39
|
+
任何 list API 先检查 total count,循环分页拉完再统计。默认 limit 只取部分数据就汇报 = 严重错误。
|
|
40
|
+
|
|
41
|
+
### Shell 输出要截断
|
|
42
|
+
大量输出用 `| head -n 50` 截断,避免 context 爆炸。
|
|
43
|
+
|
|
44
|
+
### 不要自我合理化
|
|
45
|
+
- ❌ "看起来对" 不等于验证
|
|
46
|
+
- ❌ "应该没问题" 不是测试结果
|
|
47
|
+
- ❌ 跳过验证步骤不叫"高效",叫偷懒
|
|
48
|
+
- ✅ 有输出的验证才算验证
|
|
49
|
+
|
|
50
|
+
## 长任务监控
|
|
51
|
+
- 预计 ≥30 分钟的异步任务,启动后必须设置监控
|
|
52
|
+
- "已启动" ≠ 完成,要持续追踪进度
|
|
53
|
+
- 完成后自动执行后续流程
|
|
54
|
+
- 失败自动重试,3 次失败才升级
|
|
55
|
+
|
|
56
|
+
## Skill 自进化
|
|
57
|
+
每次使用 Skill 后自动反馈:
|
|
58
|
+
1. ✅ 成功 → 记录新触发场景
|
|
59
|
+
2. ⚠️ 部分成功 → 记录限制条件
|
|
60
|
+
3. ❌ 失败 → 分析根因,修正 Skill 内容
|
|
61
|
+
4. 🔁 重复 3 次的经验 → 晋升为硬性规则
|
|
62
|
+
5. 💀 连续 5 次失败 → 标记禁用
|