Skip to content

Commit 4e09192

Browse files
M09Icclaude
andcommitted
fix: resolve all 21 markdown lint errors
- MD001: change h3 to h2 in README.md (heading increment) - MD022: add blank lines around headings in SKILL.md - MD032: add blank lines around lists in SKILL.md, okr-review.md Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 31a0d2e commit 4e09192

File tree

4 files changed

+13
-1
lines changed

4 files changed

+13
-1
lines changed

.claude/skills/okr/SKILL.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,7 @@ license: MIT
3131
方向:**全维度自举** — 质量闭环 + 架构可维护 + 生态扩张全部推进。
3232
投入:**全力冲刺**,本季度主力项目。
3333
底线(P0):
34+
3435
1. OKR Creator 自己有可运行的 OKR,每日 Action 能跑通
3536
2. SKILL.md 的修改有 CI 门禁,不会悄悄坏掉
3637
3. 至少一个平台(Claude Code)完成 E2E 自动化

.github/prompts/okr-review.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,11 +3,13 @@
33
请阅读 .claude/skills/okr/SKILL.md 中的项目 OKR,然后对每个 KR 的完成情况进行评估。
44

55
执行以下步骤:
6+
67
1. 读取 .claude/skills/okr/SKILL.md,理解项目的 OKR
78
2. 对每个 KR,运行其 Harness 或通过分析 repo 现状来评估完成度
89
3. 用 Markdown 格式输出评估报告
910

1011
要求:
12+
1113
- 每个 KR 的证据必须基于实际检查(读文件、跑命令),不要猜
1214
- 不要与人类确认任何事情,直接执行并输出结果
1315
- 如果 .claude/skills/okr/SKILL.md 不存在,输出 "OKR not found"

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# okr
22

3-
### AI-powered OKR Creator — 给你的项目定方向,用 PUA 话术逼你执行
3+
## AI-powered OKR Creator — 给你的项目定方向,用 PUA 话术逼你执行
44

55
> A [PUA](https://github.com/tanweai/pua)-like project — 基于 PUA skill 的理念和话术体系,专注于项目目标管理。PUA 让 AI 不敢摆烂,OKR 让 AI 知道往哪卷。
66

skills/okr-creator/SKILL.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,7 @@ license: MIT
1515
这个 skill 适用于**所有类型的项目**:代码开发、技术研究、内容写作、产品规划、运营策略、设计系统、文档体系——任何有目录结构、有交付物、有目标的项目。
1616

1717
它做三件事:
18+
1819
1. **全面诊断** — 深度分析目标项目的内容、文档、历史、结构,找出它"是什么"和"该往哪走"
1920
2. **共建 OKR** — 引导用户明确意图,结合诊断数据,输出结构化的 Objectives 和 Key Results
2021
3. **落地为 Skill** — 把 OKR 写入 `.claude/skills/okr/SKILL.md`,让每次 AI 协作都有方向感
@@ -61,36 +62,42 @@ license: MIT
6162
好,数据你拿到了。现在该干正事了——给我做个全面体检,别漏项。
6263

6364
#### 维度一:项目愿景与里程碑
65+
6466
- 这个项目到底想解决什么问题?别跟我说"就是个工具"——工具也有灵魂。
6567
- 当前处于什么阶段?(早期探索 / 快速成长 / 稳定成熟 / 维护模式)
6668
- 下一个里程碑应该是什么?你看完材料还说不出来,说明你没读进去。
6769
- 是否有明确的 roadmap?没有的话,这就是你的第一个 Objective。
6870

6971
#### 维度二:交付质量
72+
7073
- 代码项目:测试覆盖率、Lint 规则、类型安全、代码复杂度
7174
- 内容项目:发布频率、内容完整度、一致性、错误率
7275
- 产品项目:功能完成度、用户反馈、Bug 数量
7376
- 通用:当前交付物的质量水平,有没有"差不多就行"的心态?
7477

7578
#### 维度三:历史债务
79+
7680
- TODO / FIXME / HACK 数量和分布(代码项目)
7781
- 未完成的承诺、搁置的计划、遗留问题(所有项目)
7882
- 过时的依赖、过期的文档、失效的链接
7983
- 临时方案(workaround)有多少变成了永久方案?
8084

8185
#### 维度四:结构与架构
86+
8287
- 项目的组织结构是否清晰?一个新人来了能不能 10 分钟搞懂?
8388
- 模块/目录/内容的边界是否明确?
8489
- 是否存在结构级别的改进空间?
8590
- 扩展性怎么样——再加一倍内容会不会崩?
8691

8792
#### 维度五:文档完善度
93+
8894
- README 是否完整?一个陌生人能不能看完 README 就上手?
8995
- 有没有面向贡献者的指南?
9096
- 架构/设计文档是否存在?
9197
- 变更日志是否在维护?
9298

9399
#### 维度六:自动化与流程
100+
94101
- 有没有自动化的质量检查(CI/CD、lint、测试)?
95102
- 发布/部署流程是手动还是自动?
96103
- 有没有代码审查/内容审查流程?
@@ -666,11 +673,13 @@ gh label create "okr-review" --description "OKR daily review tracking" --color "
666673
当运行在 Agent Team 上下文时:
667674
668675
### Leader 行为
676+
669677
- spawn teammate 时附带项目的 OKR 上下文:`本项目的核心 OKR 是: [O1/O2/O3],你负责的任务与 KR X.Y 对齐`
670678
- 任务分配时确保每个任务与某个 KR 关联
671679
- 复盘时对照 OKR 评估进展
672680
673681
### Teammate 行为
682+
674683
- 开工前读 `.claude/skills/okr/SKILL.md`
675684
- 完成任务后汇报时标注关联的 KR
676685
- 发现与 OKR 不对齐的工作时主动提出

0 commit comments

Comments
 (0)